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AmigaDOS  Enhancer  Software 

This  Enhancer  package  provides  the  necessary  software  to  upgrade  your 
Amiga  computer  to  the  new  1 .3  operating  system.  Included  in  this  package  are: 

•  Kickstart  Version  1 .3  diskette  (for  Amiga  1 000  owners) 

•  Workbench  Version  1 .3  diskette 

•  Extras  Version  1 .3  diskette 

•  Program  License  Agreement 

By  upgrading  to  Version  1 .3,  you'll  maximize  the  power  of  your  Amiga  comput- 
er. Version  1 .3  improves  upon  the  existing  technology,  expands  the  Amiga's 
capabilities,  and  enhances  many  software  applications. 

To  make  full  use  of  Version  1 .3  Software,  you  need  to  use  the  new  Version  1 .3 
Kickstart.  If  you  are  an  Amiga  1 000  owner,  this  is  extremely  simple:  just  use  the 
new  1 .3  Kickstart  diskette  instead  of  your  old  1 .2  Kickstart  disk  when  you  boot 
the  system. 


YOU  CANNOT  USE  THE  KICKSTART  DISK  WITH  THE  AMIGA  500  OR 
AMIGA  2000.  Instead  you  may  wish  to  replace  the  Kickstart  ROM  in  your 
computer  with  the  1 .3  Kickstart  ROM.  The  1 .3  Kickstart  ROM  is  available 
from  an  authorized  Commodore  Service  Center.  The  ROM  will  be  installed 
at  the  service  center.  Please  request  part  number  314864-01 . 


You  can  use  the  new  software  without  the  1 .3  Kickstart  ROM  in  place.  The  only 
application  that  will  not  be  available  is  the  reboot  function  of  the  Recoverable 
ramdrive.device,  explained  later  in  this  manual.  Also,  Amiga  2000  owners  who 
have  an  A2090A  Hard  Disk  Controller  Card  will  not  be  able  to  autoboot  off  their 
hard  disk  until  the  1 .3  Kickstart  ROM  is  installed  in  their  machine. 
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ABOUT  THIS  MANUAL 

Welcome  to  the  new  Version  1.3  AmigaDOS  Enhancer  Software.  This  manual, 
which  assumes  a  familiarity  with  the  information  in  the  Introduction  to  the  Commo- 
dore-Amiga manuals,  covers  both  Workbench  Version  1.3  (Chapters  1  through  5) 
and  Extras  Version  1.3  (Chapters  6  and  7). 

The  first  several  chapters  cover  all  the  changes  made  to  the  basic  Workbench 
diskette.  This  new,  updated  version  of  the  Workbench  diskette  improves  upon 
many  of  the  features  included  in  Version  1.2.  Several  new  programs  have  also 
been  added  to  enhance  your  computing  pleasure: 

SHELL  —  acts  like  a  CLI  but  permits  editing  of  lines  and  lets  you  backtrack 

through  previous  commands 
RxFonts  —  lets  you  update  the  Workbench's  font  directory  after  adding  new 

fonts 
MORE  —  allows  you  to  display  ASCII  text  files 
CMD  —  redirects  serial  or  parallel  output  to  a  file 

There  are  several  new  AmigaDOS  commands,  and  some  of  the  original  commands 
have  been  expanded  upon  and  revised  Also,  a  new  graphic  select  screen  which 
supports  extended  printer  graphics  features  has  been  added  to  Preferences. 

All  of  this  new  material  is  covered  in  this  manual.  First,  it  takes  you  through  drawer 
by  drawer  to  explain  any  changes  to  the  different  programs.  Later,  for  users  familiar 
with  AmigaDOS,  it  explores  the  new  commands  and  handlers,  and  gives  you 
instructions  on  modifying  your  startup  sequences. 

The  later  part  of  the  book  documents  the  Extras  disk.  The  Extras  window  displays 
icons  for  AmigaBasic,  BasicDemos,  FD1.3,  Tools  and  PCUtilities.  However,  the 
disk  also  includes  directories  which  contain  printer  drivers,  keymaps  and  fonts  that 
did  not  fit  onto  the  Workbench  disk. 

The  utilities  in  the  Tools  and  PCUtilities  drawers  are  covered  in  chapters  six  and 
seven.  Since  AmigaBasic,  BasicDemos,  and  FD1.3  pertain  to  the  Amiga  Basic 
programming  language,  which  is  an  adaptation  of  Microsoft®  BASIC  developed 
especially  for  the  Amiga,  they  are  not  covered  in  this  manual.  Full  information  on 
Amiga  Basic  is  available  in  the  Amiga  Basic  manual  that  was  packaged  with  your 
computer. 


1.  THE  WORKBENCH 

The  SHELL,  NEWCON:,  and  The  CLI 

One  of  the  most  obvious  differences  between  Workbench  1.2  and  Work- 
bench 1.3  is  the  addition  of  a  SHELL  program  in  the  Workbench 
window.  (Note  that  the  Demos  drawer  has  been  removed.)  Both  the 
SHELL  and  the  CLI  (the  Command  Line  Interface,  located  in  the  System 
drawer)  allow  you  to  communicate  with  your  Amiga  computer  through 
AmigaDOS  commands.  Any  of  the  programs  on  the  Workbench  disk  can 
be  run  from  either  the  SHELL  or  the  CLI.  The  main  difference  between 
the  two  is  that  the  SHELL  provides  an  upgraded  CLI  environment  — 
meaning  that  the  SHELL  can  do  everything  that  the  CLI  can  do,  and 
more. 

Since  the  SHELL  and  the  CLI  share  many  similarities,  the  functions  that 
pertain  to  both  are  explained  first.  Then,  the  additional  capabilities  of  the 
SHELL  are  explored. 

Startup  Files 

When  the  SHELL  or  CLI  is  opened,  by  double-clicking  on  its  icon,  the 
utility  executes  the  commands  in  its  startup  file.  For  the  SHELL  that  file  is 
s:  Shell-Startup,  and  for  the  CLI  it  is  s:CLI-Startup.  Both  startup  files  are 
located  in  the  Workbench's  S:  directory. 

A  common  command  in  both  startup  files  is  the  PROMPT  command.  The 
PROMPT  command  specifies  the  prompt  that  is  present  when  the 
SHELL  or  CLI  window  is  opened.  When  the  CLI  is  opened,  it  displays  a 
simple  numerical  prompt  —  1>.  However,  the  SHELL  opens  with  a 
"l.SYS:>"  prompt  which  will  change  to  reflect  changes  to  the  current 
directory.  For  instance,  if  you  were  to  type: 

cd  utilities 

The  prompt  would  change  to: 

1. Workbench  1 .3:utilities> 

You  can  change  the  prompts  for  the  SHELL  by  using  the  PROMPT 
command: 

PROMPT  %N>  displays  only  the  CLI  number 

PROMPT  %N.%S>      displays  the  CLI  number,  a  period,  then  the 

current  directory 
PROMPT  %S.%N>      displays  the  current  directory,  a  period,  then 

the  CLI  number 

If  you  want  a  different  prompt  to  appear  when  you  open  the  window,  edit 
the  s:  Shell-Startup  file.  To  do  this,  use  the  AmigaDOS  ED  command,  the 
MEMACS  utility,  or  any  other  text  editor. 
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TOOL  TYPES 

When  you  select  an  icon  and  choose  INFO  from  the  Workbench  menu,  a 
window  appears  displaying  more  detailed  information  about  the  utility 
represented  by  the  icon.  You  can  control  different  variables  which  affect 
the  SHELL  and  the  CLI  by  using  the  Workbench  menu's  INFO  item  to 
change  the  utility's  TOOL  TYPES.  A  utility's  TOOL  TYPES  is  a  group  of 
characteristics  that  govern  a  utility's  behavior.  When  you  open  the  INFO 
window,  you  can  change  the  default  TOOL  TYPES  by  using  the  add/ 
delete  gadgets  in  the  TOOL  TYPES  box. 

You  can  add  the  following  TOOL  TYPES  to  both  the  SHELL  and  the 
CLI  icons. 

WINDOW  =  window  specification 

This  TOOL  TYPES  allows  you  to  control  the  placement,  size,  and  han- 
dler that  the  new  SHELL  or  CLI  will  use.  A  full  window  specification  must 
be  used,  for  instance: 

WINDOW  =  CON:0/10/640/100/NEWCLI 

WINDOW  =  NEWCON:0/l/640/100/AmigaShell 

The  format  for  a  window  specification  is  '  'Handler:  x/y/w/h/name", 
where: 

Handler = CON:  orNEWCON: 

x  =  <#  of  pixels  from  left  edge  of  screen  to  left  edge  of  window>/ 

y  =  <#  of  pixels  from  top  of  screen  to  top  of  window>/ 

w  =  <  width  of  window,  in  pixels>/ 

h  =  < height  of  window,  in  pixels>/ 

name  =  <title  for  window> 

In  the  first  example  above,  a  CON:  window  would  open  flush  with  the  left 
edge  of  the  screen  and  ten  pixels  from  the  top  of  the  screen.  The  window 
would  be  640  pixels  wide  and  100  pixels  high.  NEWCLI  would  appear  in 
the  window's  title  bar. 

The  handlers  you  can  choose  from  are  CON:  or  NEWCON:.  CON:  is  the 
standard  Amiga  window,  while  NEWCON:  is  a  new  alternative  window. 
NEWCON:  allows  command  line  editing  and  has  a  history  buffer.  The 
SHELL  is  an  example  of  a  NEWCON:  window.  (NEWCON:  is  explained 
in  Chapter  3,  Other  Workbench  Directories.) 

STACK = 

This  TOOL  TYPES  allows  you  to  specify  the  initial  stack  size  used  by  the 
CLI  or  SHELL.  The  stack  size  is  an  amount  of  memory  reserved  for  a 
specific  tool.  (Default  for  most  utilities  is  4000  bytes.) 

Multiple  Icons 

Multiple  icons  for  both  of  these  utilities  can  be  created  by  copying  any 
project  TYPE  icon,  such  as  the  SHELL,  or  even  the  Pointer  icon  in  the 
Preferences  window.  (You  can  tell  if  an  icon  is  a  project  icon  by  the  TYPE 
description  in  the  icon's  INFO  window.)  Set  the  default  tool  in  the  INFO 
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window  to  SYS:System/CLI,  and  set  the  WINDOW  =  and  STACK  = 
TOOL  TYPES  to  different  values.  This  gives  you  an  easy  way  to  bring  up 
windows  in  different  locations. 

For  instance,  if  you  wanted  an  additional  SHELL,  called  Shell2,  in  the 
Utilities  drawer,  you  would: 

1)  Use  the  COPY  command  to  make  a  copy  of  the  Shell  icon* 
COPY  Sys :  Shell .  info  to  Sys :  Utilities/Shell2 .  info 

2)  Open  the  Utilities  window 

3)  Check  the  TOOL  TYPES  of  the  Shell2  icon  to  make  sure  that  the 
default  tool  is  set  to  SYS:System/CLI 

4)  Change  the  WINDOW  =  and  STACK  =  TOOL  TYPES, 
if  desired. 

*Or,  you  could  copy  the  icon  using  the  Workbench  menu's  Duplicate  item. 

Additional  Features  of  the  SHELL 

One  of  the  advantages  of  using  the  SHELL  is  that  it  saves  a  lot  of  typing. 
With  the  SHELL,  you  can  edit  a  command  line.  When  using  the  CLI,  if 
you  make  a  typing  error  when  entering  a  command,  you  have  to  use  the 
backspace  key  and  delete  all  the  other  characters  until  you  reach  the 
error.  With  the  SHELL,  you  can  use  the  left  cursor  key  to  move  over  the 
characters,  correct  the  error,  and  hit  RETURN.  There  is  no  need  to  re- 
type the  whole  command. 

The  SHELL  has  a  *  'history.' '  This  means  that  you  can  move  through 
previous  commands  by  using  the  up  cursor  key.  Instead  of  re-typing  the 
same  line  you  executed  three  or  four  commands  ago,  you  can  recall  each 
previous  command  by  pressing  the  up  cursor  key.  You  can  also  search 
for  specific  commands  by  typing  a  partial  command  line,  then  pressing 
Shift  and  the  up  cursor  key  (or  Control-R).  For  instance,  type  DIR  and 
press  Shift-up  cursor  key,  and  you  will  be  returned  to  the  last  command 
to  perform  a  DIR  of  any  directory. 

Once  you've  moved  back  a  few  commands,  you  can  move  forward  with 
the  down  cursor  key.  This  lets  you  retrace  what  you've  already  done,  in 
case  you've  forgotten  how  you  achieved  a  specific  result  or  action. 
Pressing  Shift  and  the  down  cursor  key  (or  Control-B)  will  bring  you  to 
the  bottom  of  the  history  buffer  and  leave  you  on  a  blank  command  line. 

Some  other  ways  to  edit  the  command  line  are: 

The  Delete  key  Deletes  the  characters  at  the  cursor 

The  Backspace  key  Deletes  the  character  to  the  left 

of  the  cursor 
Control-K  Deletes  everything  from  the  cursor 

forward  to  the  end  of  the  line 
Control-U  Deletes  everything  from  the  cursor 

backward  to  the  start  of  the  line 
Control-X  Deletes  the  entire  line 
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Shift-Left  Cursor  key         Moves  cursor  to  start  of  line 

(or  Control-A) 
Shift-Right  Cursor  key       Moves  cursor  to  end  of  line 

(or  Control-Z) 
Control-W  Moves  cursor  to  the  next  tab  stop. 

With  the  SHELL,  you  can  create  aliases  for  AmigaDOS  commands. 
Think  of  an  alias  as  a  shortcut  for  commonly  used  commands.  The  format 
for  creating  an  alias  is: 

ALIAS  <alias>  <string> 

For  instance,  if  you  commonly  perform  a  DIR  of  dfl:,  you  can  create  an 
alias  called  *  'dl"  that  would  perform  the  same  operation: 

ALIAS  dl   "DIR  dfl:" 

When  the  SHELL  encounters  an  alias,  it: 

1)  replaces  the  alias  with  the  <string>, 

2)  adds  the  rest  of  the  command  line  you  have  typed, 

3)  executes  the  entire  command  string. 

If  you  want  to  be  able  to  substitute  a  filename  or  other  instruction  within 
an  alias,  use  square  brackets  ([])  to  indicate  where  the  insertion  will  take 
place.  For  example: 

ALIAS  Is  "LIST  []  NODATES" 

In  this  case  the  brackets  represent  the  filename  or  directory  to  be  speci- 
fied. For  instance: 

Is  dfl: 

will  list  the  directories  and  files  on  the  diskette  in  dfl:  without  listing  any 
dates  or  times.  Typing '  'Is  c' '  will  list  all  the  files  in  the  C:  directory  without 
any  dates  or  times. 

Some  special  features  pertaining  to  aliases: 

•  Aliases  are  specific  to  a  certain  SHELL.  Aliases  created  in  one 
SHELL  will  not  work  in  a  newly  created  SHELL.  The  s:Shell- 
Startup  file  is  executed  automatically  whenever  the  NEWSHELL 
command  is  used.  You  can  place  commonly  used  aliases  in  the 
s: Shell-Startup  file  so  that  you  don't  have  to  re-create  them  each 
time  you  open  a  SHELL.  (See  Chapter  5,  Changing  Your  Startup 
Sequences.) 

•  ALIAS  typed  by  itself  lists  the  current  aliases. 

•  To  remove  an  alias,  type  ALIAS  <alias>  with  no  string. 

•  A  space  is  not  automatically  placed  on  the  end  of  a  string.  If  you 
need  a  space,  be  sure  to  place  one  in  the  string. 

The  SHELL  also  supports  the  use  of  the  new  script  protection  bit.  With 
Version  1.2,  the  available  protection  bits  for  a  file  were  r  (readable),  w 
(writable),  e  (executable),  and  d  (deleteable).  Version  1.3  supports  a  few 
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additional  protection  bits  —  script,  archive  and  pure.  (The  archive  and 
pure  bits  are  explained  in  Chapter  2.  See  the  explanations  of  the  PRO- 
TECT and  RESIDENT  commands.) 

Use  the  PROTECT  command  to  set  the  script  bit  on  a  file.  The  SHELL 
will  then  execute  that  file  as  an  EXECUTE  script  file  instead  of  as  a 
command.  To  speed  up  the  execution  of  the  script  file,  make  the  EX- 
ECUTE command  "resident",  using  the  AmigaDOS  RESIDENT  com- 
mand. This  is  usually  done  in  the  Workbench's  Startup-Sequence.  For 
the  most  effective  use  of  this  function,  you  may  want  to  do  the  following: 

•  Make  sure  the  S:  directory  is  in  the  Amiga  command  search  path, 
via  the  PATH  command  (you  may  want  to  do  this  in  the  Startup- 
Sequence  file),  and/or 

•  Copy  the  entire  S:  directory  or  frequently  used  script  files  to 
RAM:,  and  make  sure  RAM:  is  in  the  command  path. 

There  are  some  scripts  in  the  S:  directory  that  can  be  used  with  the 
SHELL'S  ALIAS  command  to  give  wildcard  capability  to  commands  that 
don't  already  have  it.  The  scripts  are  SPAT,  which  allows  pattern  match- 
ing for  single  argument  commands,  and  DPAT,  which  is  used  with  double 
argument  commands.  For  example: 

alias  ren  "execute  s:dpat  rename  []" 
alias  pro  "execute  s:spat  protect  []" 

gives  wildcard  capability  to  the  RENAME  and  PROTECT  commands, 
respectively.  (See  The  AmigaDOS  Manual  for  instructions  on  using  wild- 
cards. Examples  of  SPAT  and  DPAT  are  given  in  Chapter  3.) 

The  SHELL  supports  normal  redirection  using  the  <  and  >  symbols,  as 
well  as  an  appended  form  of  redirection  using  ».  Redirection  refers  to 
routing  the  input  for  or  output  from  a  command  to  a  file.  Note  that  » 
does  not  create  a  file,  but  merely  appends  information  to  an  existing  file. 
You  can  also  include  comments  in  the  command  line  by  typing  them  after 
a  semi-colon  (;). 

The  System  Drawer 

As  in  Version  1.2,  the  System  drawer  contains  the  CLI,  NoFastMem, 
DiskCopy,  FastMemFirst,  Format,  SetMap,  and  InitPrinter.  However,  two 
new  utilities,  FixFonts  and  MergeMem,  have  been  added,  while  the  Say 
program  has  been  moved  to  the  Utilities  drawer  and  IconEd  to  the  Extras 
disk. 

NoFastMem 

Some  very  old  software  programs  may  not  run  properly  when  memory 
other  than  CHIP  RAM  is  present  in  the  Amiga  system,  such  as  the  FAST 
RAM  present  in  the  A2000  or  the  additional  RAM  provided  by  an  A501 
memory  cartridge  in  the  A500.  In  this  case,  double-clicking  on  the 
NoFastMem  icon  forces  the  Amiga  to  only  use  resident  CHIP  RAM.  The 
icon  works  like  a  toggle  switch.  To  restore  the  expansion  memory  to  the 
system,  click  on  the  NoFastMem  icon  again. 
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If  you  are  working  through  the  CLI,  the  expansion  memory  can  be  turned 
on  again  by  sending  the  NoFastMem  program  a  '  'break' ',  either  via  the 
BREAK  command  or  by  typing  Control-C.  Control-C  will  only  work  if 
you  didn't  start  the  program  with  the  RUN  command. 

FastMemFirst 

This  program  ''rearranges"  the  Amiga's  memory  list,  affecting  when 
memory  at  $C00000  will  be  allocated.  This  allows  programs  to  use  fast 
memory  before  $C00000  memory,  resulting  in  faster  system  operation. 
Unless  specifically  requested  to  use  CHIP  RAM,  the  Amiga  defaults  to 
using  $C00000  RAM,  FAST  RAM,  then  CHIP  RAM.  FastMemFirst 
changes  the  order  of  allocation  to  FAST  RAM,  $C00000  RAM,  then 
CHIP  RAM. 

MergeMem 

You  may  want  to  use  MergeMem  if  you  have  additional  RAM  expansion 
boards  added  to  your  Amiga  computer.  When  you  double-click  on  this 
icon,  MergeMem  attempts  to  merge  the  MemLists  (memory  lists)  of 
sequentially  configured  RAM  boards.  The  RAM  boards  must  have  the 
same  attributes  as  contiguous  expansion  RAM.  Memory  from  separate 
RAM  boards  is  usually  kept  in  separate  memory  pools.  MergeMem 
attempts  to  merge  the  separate  memory  pools  into  one  large  pool  to 
allow  allocation  of  larger  memory  blocks  by  programs.  MergeMem  only 
merges  memory  of  the  same  attributes. 

To  run  MergeMem  from  the  CLI,  simply  type  MERGEMEM.  If  it  is  not 
possible  to  merge  the  memory  pools,  you  will  receive  a  message  listing 
the  RAM  configurations  and  stating  that  no  merging  is  possible. 

Format 

Double-clicking  on  this  icon  results  in  a  requester  telling  you  to  select 
Initialize  from  the  Workbench's  Disk  menu.  If  you  want  to  format  a  disk, 
select  Initialize  or  use  the  FORMAT  command,  if  you're  familiar  with  the 
CLI.  The  format  for  this  command  is: 

FORMAT  DRIVE  <drive>  NAME  <name>  [NOICONS] 
[QUICK][FFS|NOFFS] 

The  NOICONS  option  prevents  a  Trashcan  icon  from  being  added  to  the 
newly  formatted  disk. 

The  QUICK  option  specifies  that  FORMAT  will  only  format  and  create 
the  root  block  (and  track),  the  boot  block  (and  track),  and  create  the 
bitmap  blocks.  This  is  used  when  reformatting  a  previously  formatted 
floppy  disk. 

The  FFS  and  NOFFS  options  pertain  to  hard  disks.  This  option  overrides 
the  MountList  keywords.  The  FFS  option  marks  the  disk  as  being  used 
with  the  FastFileSystem.  The  NOFFS  option  marks  the  disk  as  being  used 
with  the  default  file  system.  Since  FORMAT  checks  to  see  if  an  alternate 
file  system  is  specified  in  the  MountList,  both  options  are  available.  If  the 
FastFileSystem  is  specified,  then  the  FFS  option  is  automatically  used.  If 
another  file  system  is  in  the  MountList,  the  NOFFS  option  is  used.  If  your 
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hard  disk  is  divided  into  partitions,  you  must  set  the  DosType  keyword  in 
the  MountList  to  the  appropriate  setting  for  the  file  system  you  are  using. 
(There  is  a  section  on  the  MountList  in  Chapter  3.) 

SetMap 

Allows  you  to  select  the  correct  keymap  for  your  keyboard.  A  keymap 
tells  the  computer  which  character  to  register  for  each  key  on  the  key- 
board. With  an  A2000,  your  choice  is  usal.  The  usal  keymap  is  for  use 
with  the  A500  and  A2000,  but  it  will  also  work  on  the  A1000.  Usal 
enables  the  new  keys  on  the  keypad. 

Additional  keymaps  are  included  on  the  Extras  disk  (in  the  devs/keymaps 
directory)  and  can  be  copied  over  to  your  Workbench  diskette.  (See  the 
Keymaps  section  of  Chapter  3.)  The  usaO  keymap  is  for  compatibility 
with  some  old  software  that  made  assumptions  about  Version  1.0  Kick- 
start.  The  usa2  keymap  is  for  the  Dvorak  keyboard.  The  others  are 
international  keymaps  for  use  with  various  European  and  Scandanavian 
keyboards. 

FixFonts 

Updates  the  .font  files  in  the  FONTS:  directory.  This  program  is  used  after 
fonts  have  been  added  to  or  deleted  from  any  of  the  subdirectories  in  the 
FONTS:  directory.  FixFonts  corrects  all  the  .font  files,  making  them 
accurately  reflect  the  current  contents  of  the  subdirectories  in  FONTS:. 

InitPrinter 

Selecting  this  icon  initializes  your  printer  using  the  printer  settings  speci- 
fied in  Preferences.  InitPrinter  sends  escape  codes  to  the  printer  device 
which  causes  the  printer  device  to  read  the  variables  from  Preferences. 
This  command  can  be  used  from  either  the  Workbench  or  CLI. 


The  Prefs  Drawer 


With  Version  1.3,  Preferences  is  now  in  the  Prefs  drawer.  When  you 
open  the  drawer,  a  window  appears  and  lets  you  choose  from  five  icons: 

Preferences  —  opens  the  main  Preferences  window 

Pointer  —  opens  the  Edit  Pointer  window 

Printer  —  opens  the  Change  Printer  window 

Serial  —  opens  the  Change  Serial  window 

CopyPrefs  —  copies  the  system  configuration  to  df0:devs  (this  is 

useful  for  non-autobooting  hard  drive  systems) 

Even  if  you  enter  the  Pointer,  Printer  or  Serial  window  directly,  you  are 
still  returned  to  the  main  Preferences  window  when  you  exit  You  must 
select  Save  on  the  Preferences  window  in  order  to  save  any  changes  you 
made  to  another  window.  After  selecting  Save,  Use,  or  Cancel,  you  will 
be  returned  to  the  Workbench  screen  or  CLI  window. 
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Also,  you  can  now  specify  command  line  arguments  when  running 
Preferences  from  the  CLI.  The  format  is: 

PREFERENCES  [POINTER|PRINTER|SERIAL] 

The  option  specifies  which  window  to  open. 

There  have  been  changes  made  to  both  the  main  Preferences  window 
and  the  Change  Printer  window.  The  Change  Serial  and  Edit  Pointer 
windows  remain  the  same  as  with  Version  1.2. 

The  Main  Preferences  Window 

The  only  change  to  the  main  Preferences  window  is  that  the  CLI  On/Off 
option  has  been  removed.  Also,  if  your  system  is  equipped  with  a  battery 
backed-up  clock,  the  date  and  time  are  automatically  updated  whenever 
you  choose  the  Save  gadget  on  the  main  Preferences  window. 

The  Change  Printer  Window 

The  Change  Printer  window  remains  the  same,  except  that  the  Graphic 
Select  gadget  has  been  replaced  by  two  new  gadgets:  Graphic  1  and 
Graphic  2.  Also,  the  only  printer  driver  included  on  the  Workbench  disk  is 
Generic.  All  the  other  printer  drivers  are  now  on  the  Extras  disk.  You 
must  use  InstallPrinter,  in  the  Utilities  drawer,  to  copy  printer  drivers  to 
the  Workbench's  DEVS:printers  directory.  Please  see  Chapter  4,  Printer 
Drivers,  to  determine  which  printer  driver  works  with  your  printer. 

Graphic  1 

The  new  Graphic  1  gadget  is  equivalent  to  the  VI. 2  Graphic  Select 
gadget  and  is  used  to  request  the  first  of  two  printer  graphic  Preferences 
windows. 

There  is  a  new  Print  Shade  selection:  Gray  Scale2.  This  shade  is  for 
printing  pictures  designed  using  the  A2024  Monitor  (which  supports  a 
maximum  of  four  shades  of  gray). 

Graphic  2 

Selected  by  clicking  the  Graphic  2  gadget  in  the  Change  Printer  window, 
this  new  Preferences  window  supports  extended  printer  graphics  fea- 
tures. The  various  gadgets  are  as  follows: 

Smoothing  [ON|OFF]  —  attempts  to  smooth  diagonal  lines.  This 
option  is  best  suited  for  use  with  programs  that  do  graphic  dumps  of 
text  (like  ProWrite,  PageSetter,  CityDesk,  Publisher  1000,  NotePad, 
etc.).  This  technique  incurs  an  approximate  2:1  speed  penalty  on 
printing.  Note:  Floyd-Steinberg  (F-S)  dithering  cannot  be  used  in 
conjunction  with  Smoothing.  If  F-S  is  enabled  when  Smoothing  is 
turned  on,  the  dithering  mode  will  automatically  change  to  Ordered. 
(Dithering  is  explained  later  in  this  section.)  Default  is  OFF. 

Left  Offset  —  horizontally  offsets  the  printed  picture.  This  option 
effectively  sets  up  a  left  margin.  The  offset  can  be  entered  in  incre- 
ments of  tenths  of  an  inch.  The  Center  option  (below)  disables  Left 
Offset  Default  is  0.0  inches. 


1  -8  The  Workbench 


Center  [ON|OFF]  —  horizontally  centers  the  printed  picture.  This 
option  overrides  the  Left  Offset  value.  Default  is  OFF. 

Density  [1  through  7]  -  selects  the  graphics  print  density.  The  lower 
the  density,  the  faster  the  print  time  (on  those  printers  with  multiple 
densities).  Refer  to  the  specifications  of  the  VI. 3  Printer  Drivers  for  a 
description  of  densities  supported  by  each  individual  printer  (includ- 
ed in  Chapter  4).  Default  is  Density  1. 

Color  Correct  R/G/B  —  tries  to  better  match  the  screen  colors  to  the 
colors  produced  by  the  printer.  This  option  selectively  tries  to  match 
all  shades  of  either  red  (R),  green  (G),  or  blue  (B)  from  the  screen  to 
the  printer.  Without  color  correction,  the  printer  device  can  print  all 
4,096  colors  displayed  by  the  Amiga  on  a  color  printer.  However,  as 
color  correction  is  applied,  the  total  number  of  printed  colors  is 
reduced  to  a  low  of  3,172  (308  shades  are  lost  per  color  selected). 

To  see  the  effect  of  this  option,  print  out  a  picture  with  solid  red, 
green,  and  blue  shades  twice;  first  with  the  Color  Correct  option  on, 
and  then  with  it  off.  Now  compare  the  two  pictures  with  the  screen 
display.  The  shades  of  the  color  corrected  picture  should  more 
closely  represent  the  colors  displayed  on  your  monitor.  Default  is  no 
color  correction  (R,  G,  and  B  are  not  selected). 

Dithering  [Ordered|Halftone|F-S]  -  sets  the  dithering  mode.  Dither- 
ing refers  to  the  printing  of  dots  of  different  colors  in  such  a  way  that 
they  are  so  small  and  close  together  that  the  eye  perceives  them  as 
one  color.  This  enables  you  to  produce  printouts  with  various  shades 
while  the  printer  only  uses  four  colors.  Default  is  ORDERED.  Note: 
when  a  Shade  of  Black  and  White  is  selected  (from  the  Graphic  1 
screen),  changing  the  dither  method  has  no  effect  on  the  printout. 

Ordered  —  Color  intensities  on  the  printer  are  formed  using  an 
ordered  dither  method.  Ordered  dithering  produces  shades  on 
the  printer  using  an  ordered  pattern  of  dots. 

Halftone  —  Color  intensities  on  the  printer  are  formed  using  a 
halftone  dither  method.  This  technique  is  similar  to  the  one 
used  in  newspapers  and  comic  books.  It  works  best  on  high 
density  printers  (greater  than  150  dots  per  inch). 

F-S  —  Color  intensities  on  the  printer  are  formed  using  the 
Floyd-Steinberg  error  distribution  method.  This  option  incurs 
an  approximate  2:1  speed  penalty  when  printing.  Note:  Select- 
ing this  option  automatically  turns  off  Smoothing  as  they  can 
not  be  used  in  conjunction  with  each  other.  F-S  works  best  on 
high  density  printers  (greater  than  150  dots  per  inch). 

Scaling  [Fraction  | Integer]  —  selects  the  scaling  method.  Default  is 
FRACTION. 

Fraction  —  Normal  scaling  is  performed. 

Integer  —  Every  dot  on  the  screen  is  guaranteed  to  appear  as 
an  even  number  of  dots  on  the  printout  in  both  the  x  and  y 
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dimensions.  For  example,  if  the  source  picture  is  320  x  200,  the 
printed  picture  width  will  be  either  320,  640  or  960  dots  wide, 
etc.  The  height  will  be  200,  400  or  600  dots  high,  etc.  This 
option  should  be  selected  when  trying  to  print  a  picture  that 
contains  thin  vertical  and  horizontal  lines  (like  a  grid). 

The  actual  size  of  the  printed  picture  will  be  the  requested 
size  scaled  up  or  down  to  the  nearest  multiple  of  the  width  and 
height  of  the  picture.  Integer  scaling  completely  overrides  the 
aspect  feature  of  the  printer  device.  Thus  it  is  possible  to  get  a 
slightly  distorted  (non-aspect  ratio  correct)  picture.  This  option 
is  also  useful  for  printing  out  bit-image  text  (as  in  Notepad), 
since  the  fonts  will  not  be  distorted  due  to  fractional  scaling. 

Width  Limit  —  limits  the  width  of  the  printed  picture.  The  width  can 
be  limited  in  tenths  of  an  inch,  pixels  or  a  multiplication  factor. 
Default  is  0.  (See  Limits,  below.) 

Height  Limit  —  limits  the  height  of  the  printed  picture.  The  height 
can  be  limited  in  tenths  of  an  inch,  pixels  or  a  multiplication  factor. 
Default  is  0.  (See  Limits,  below. ) 

<-  Limits  [Ignore|Bounded|Absolute|Pixels|Multiply]  —  determines 
how  the  Width  and  Height  limits  are  interpreted.  Default  is  IGNORE. 

Ignore  —  The  limits  are  to  be  ignored.  (This  option  is  the  default 
and  is  included  to  remain  compatible  with  pre-V1.3  software.) 
The  printed  picture's  size  is  the  size  requested  by  the  applica- 
tion, bounded  by: 

width  =  (right  margin  -  left  margin  4-  1)/ characters  per  inch 
height  =  lines  per  page  /  lines  per  inch 

Bounded  —  The  printed  picture's  size  is  bounded  by  Width 
Limit  and  Height  Limit.  For  example,  if  the  printed  picture 
should  be  no  bigger  than  4.0  x  5.0  inches  (but  it  could  be 
smaller),  set  MaxWidth  to  40,  MaxHeight  to  50,  and  select 
Bounded.  This  option  is  provided  so  that  the  text  settings  (mar- 
gins, lines  per  page,  etc.)  need  not  be  changed  every  time  a 
graphic  print  is  made. 

Absolute  —  Width  Limit  and  Height  Limit  are  interpreted  as 
absolute  values.  The  printed  picture's  size  is  no  longer  bound- 
ed. Rather,  it  is  the  absolute  size  specified.  For  example,  if  the 
printed  picture  should  be  exactly  4.0  x  5.0  inches,  set  Max- 
Width  to  40,  Width  Limit  to  50,  and  select  Absolute.  This 
completely  overrides  the  aspect  feature  of  the  printer  device. 
Thus  it  is  possible  to  get  a  very  distorted  (non-aspect  ratio 
correct)  picture. 

There  may  be  an  instance  when  you  want  your  printout  to 
be  a  specific  width  or  height,  and  you  want  the  aspect  ratio  to  be 
correct  so  that  the  picture  is  not  distorted.  In  this  case,  set  the 
Width  Limit  or  Height  Limit  to  the  desired  dimension,  and  set 
the  other  Limit  to  zero.  When  one  dimension  is  set  to  zero,  the 
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aspect  ratio  corrects  only  that  dimension.  For  example,  if  Width 
Limit  is  set  to  40  and  Height  Limit  to  0,  then  the  printed  picture 
will  be  4.0  inches  wide  and  as  tall  as  necessary  in  order  to  be 
aspect  ratio  correct.  If  both  of  the  dimensions  are  zero,  the 
printed  picture  will  be  the  printer's  maximum  dots  wide  and  as 
tall  as  necessary  in  order  to  be  aspect  ratio  correct. 

Pixels  —  The  Width  Limit  and  Height  Limit  are  interpreted  as 
pixels,  instead  of  tenths  of  an  inch.  Otherwise,  the  same  rules 
for  the  Absolute  option  apply. 

Multiply  —  Width  Limit  and  Height  Limit  are  used  to  multiply 
the  source  picture's  width  and  height.  For  instance,  if  you 
specified  a  Width  Limit  of  2  and  a  Height  Limit  of  4,  the  printed 
picture  will  be  two  times  the  source  picture's  width  (in  pixels) 
and  four  times  the  source  picture's  height.  Thus  if  the  source 
picture  were  320  x  200,  the  printed  picture  would  be  640  (320 
x  2)  pixels  wide  and  800  (200  x  4)  pixels  high.  The  same  rules 
for  Absolute  scaling  (Width  Limit  =  0  and  Height  Limit  =  0) 
apply.  In  addition,  the  benefits  inherent  to  Integer  scaling  are 
valid  here. 

CopyPrefs 

Double-clicking  on  this  icon  brings  up  a  window  with  the  message 
"Copying  devs: system-configuration  to  DF0:DEVS."  This  is  for  users 
who  have  assigned  DEVS:  to  somewhere  other  than  the  devs  directory  of 
the  boot  disk,  for  instance,  users  with  hard  drive  systems  that  are  not 
autobooting  and  who  must  boot  off  a  floppy  disk  (i.e.,  A2090  users).  If 
you  have  changed  Preferences  on  your  hard  disk  and  want  to  update 
your  Workbench  boot  disk,  use  CopyPrefs.  CopyPrefs  will  copy  the 
system-configuration  file  from  the  hard  disk  onto  your  Workbench  disk. 
The  proper  disk  must  be  in  dfO:  when  CopyPrefs  is  started.  CopyPrefs  is  a 
script  file  which  you  can  edit  to  alter  the  COPY  command,  such  as  from 
RAD:  to  DH0:  when  using  a  recoverable  ramdrive. 


The  Utilities  Drawer 


The  Utilities  Drawer  on  Workbench  Version  1.3  has  more  than  tripled  its 
size  since  Version  1.2  was  released.  Say  and  GraphicDump  have  been 
moved  out  of  the  System  drawer  and  into  Utilities,  along  with  the  familiar 
Notepad,  Calculator  and  Clock.  In  addition,  five  new  programs  have 
been  moved  in  —  ClockPtr,  CMD,  InstallPrinter,  MORE,  and  PrintFiles. 

•  ClockPtr  —  turns  the  pointer  into  a  digital  clock 

•  CMD  —  redirects  serial  or  parallel  output  to  a  file 

•  InstallPrinter  —  copies  printer  drivers  from  the  Extras  disk  onto 

the  Workbench  disk 

•  MORE  —  allows  you  to  view  ASCII  text  files  in  a  Workbench 

window 

•  PrintFiles  —  lets  you  print  multiple  files 
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ClockPtr 

The  ClockPtr  program  changes  your  Workbench  pointer  into  a  digital 
clock  whenever  the  Workbench  backdrop  screen  is  active.  To  run 
ClockPtr  from  the  Workbench,  double-click  on  its  icon.  Move  the  pointer 
out  of  the  Utilities  window,  click  the  mouse,  and  it  becomes  a  clock. 
ClockPtr  displays  the  hour  and  minute.  To  display  minute  and  seconds, 
move  the  pointer  to  the  top  left  corner  of  the  Workbench  screen,  and  an 
interval  timer  will  be  displayed.  To  display  the  date,  move  the  pointer  to 
the  left  side  of  the  Workbench  screen. 

Close  ClockPtr  by  double-clicking  on  its  icon  or  by  typing  Control-C  if 
started  from  the  CLI.  If  ClockPtr  is  RUN  from  the  CLI  (using  the  Amiga- 
DOS  RUN  command),  use  the  BREAK  command  to  close  it. 

Use  the  DATE  or  SETCLOCK  command  to  set  the  time  (See  Chapter  2). 
CMD 

CMD  allows  you  to  redirect  either  serial  or  parallel  device  CMD 

WRITEs  to  a  designated  file,  allowing  you  to  reroute  your  printer  output 

to  a  file.  (A  CMD WRITE  is  an  internal  Amiga  function  which  controls 

the  computer's  behavior.  When  you  use  a  software  program  or  a  CLI 
command  to  send  information  to  your  printer,  the  Amiga  is  informed  of 
your  decision  via  a  CMD WRITE.) 

To  run  CMD  from  the  CLI,  the  format  is: 

CMD  <devicename>  <filename>  [OPT  s  |  m  |  n] 

<devicename>  is  either  "serial"  or  "parallel",  and  <filename>  is  the 
name  of  the  file  to  which  the  redirected  output  should  be  sent.  Note  that 
CMD  does  not  accept  *  'PAR:' '  or '  'SER:' '  as  device  names. 

The  CMD  options  are  as  follows: 

s    Skip  any  short  initial  write  (usually  a  reset  if  redirecting  a  screen 
dump)* 

m  Install  for  MULTIPLE  files  until  a  BREAK  command  or  Control-C 
is  typed 

n   Enable  NOTIFY  (helpful  progress  messages) 

*On  a  screen  dump,  the  first  CMD__WRTTE  is  usually  a  printer  reset  The  printer  device  then 
delays  long  enough  for  the  reset  to  complete  to  prevent  the  loss  of  subsequent  output  data. 
When  CMD  is  used  to  redirect  the  output  to  a  file,  this  delay  is  lost  If  your  printer  driver 
outputs  a  reset  at  the  start  of  a  dump,  use  the  s  option  to  keep  the  initial  CMD_WRITE  out  of 
the  file. 

You  can  also  use  CMD  from  the  Workbench.  You  specify  the  device 
name,  filename,  and  options  through  the  icon's  TOOL  TYPES.  Select  the 
CMD  icon,  then  choose  INFO  from  the  Workbench  menu.  CMD  recog- 
nizes the  following  parameters  in  the  TOOL  TYPES  field  of  the  CMD 
icon: 

DEVICE  Set  to  either  parallel  or  serial;  default  is  parallel. 

FILE  The  name  of  the  output  file;  default  is 

ram:CMD_file. 
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SKIP  Set  to  TRUE  to  skip  any  short  initial  write;  default 

is  FALSE  —  does  not  skip  initial  write. 

MULTIPLE  Set  to  TRUE  to  install  for  multiple  files;  default  is 

FALSE  —  does  not  install. 

NOTIFY  Set  to  TRUE  to  receive  progress  messages;  de- 

fault is  FALSE  —  no  messages  are  sent. 

Double-clicking  on  the  CMD  icon  implements  redirection  as  specified  in 
the  TOOL  TYPES. 

InstallPrinter 

InstallPrinter  is  a  program  that  lets  you  copy  a  printer  driver  from  the 
Extras  disk  to  your  DEVS:printer  directory  on  the  Workbench  disk  with- 
out having  to  use  any  AmigaDOS  commands  or  open  a  SHELL  or  CLI. 
Double-click  on  the  InstallPrinter  icon,  and  a  window  appears  displaying 
a  list  of  the  drivers  included  on  the  Extras  disk.  Type  the  name  of  the 
appropriate  driver  at  the  prompt,  and  hit  RETURN.  The  printer  driver  file 
will  be  automatically  copied  to  the  DEVS:printers  directory  of  the  Work- 
bench disk,  and  the  name  of  the  driver  will  appear  in  the  Change  Printer 
window  of  Preferences.  You  can  use  wildcards  to  copy  more  than  one 
driver.  To  quit  InstallPrinter  without  copying  a  driver,  hit  RETURN. 

MORE 

MORE  is  a  utility  for  displaying  ASCII  text  files.  There  are  two  ways  to  run 
MORE  from  the  Workbench.  If  the  text  file  has  an  icon  attached  to  it, 
select  the  MORE  icon,  then  while  holding  down  the  Shift  key, 
double-click  on  the  text  file  icon.  If  there  is  no  icon  for  the  text  file,  simply 
double-click  on  the  MORE  icon.  A  prompt  will  appear  asking  you  for  the 
name  of  the  text  file.  Be  sure  to  specify  the  complete  path. 

To  run  MORE  from  the  CLI,  the  format  is: 

MORE  <filename> 

When  you  specify  the  file  to  be  displayed,  be  sure  to  enter  the  complete 
path,  including  the  disk  name  (or  drive  number),  directory,  and  file.  If  you 
don't  specify  a  file,  MORE  will  display  a  short  explanation  and  a  prompt 
asking  you  to  enter  the  filename. 

When  you  run  MORE,  a  message  such  as  "-  More  (48%)  -"  will 
appear  at  the  bottom  of  the  window.  This  indicates  the  percentage  of  the 
file  viewed  so  far.  To  move  through  the  display,  use  the  following  key 
sequences: 


<SPACE> 

displays  the  next  page 

<BACKSPACE> 

displays  the  previous  page* 

<RETURN> 

displays  the  next  line 

< 

displays  the  first  page* 

> 

displays  the  last  page* 

%n 

displays  approximately  n%  into  the  file* 

CTRL  +  L 

refreshes  the  window 

/<string> 

MORE  will  perform  a  case  sensitive 

search  for  the  string  of  characters  speci- 

fied after  the  / 
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.<string>  MORE  will  perform  a  non-case  sensitive 

search  for  the  specified  string 
n  finds  the  next  occurrence  of  the  string 

h  help  (displays  a  list  similar  to  this  one) 

q  quit  (or  Control-C) 

E  edit  using  editor  set  in  ENV:  EDITOR 

*MORE  also  accepts  input  from  a  PIPE.  Since  standard  input  from  the  Pipe-Handler  is  of 
unknown  length,  the  commands  marked  with  an  asterisk  are  disabled  when  the  MORE  input  is 
from  a  PIPE.  (See  Chapter  3,  Other  Workbench  Directories.) 


A  case-sensitive  search  means  that  MORE  looks  for  the  string  exactly  as  it 
is  entered.  If  you  type  the  string  in  capital  letters,  MORE  will  only  look  for 
occurrences  of  the  string  that  appear  in  capital  letters.  A  non-case  sensi- 
tive search  means  that  whether  the  string  is  entered  in  upper  or  lower 
case  letters  does  not  make  a  difference. 

When  you  reach  the  last  page  of  the  display,  the  message  at  the  bottom 
of  the  screen  will  read  *  —  Less  —  \ 

When  using  MORE  from  the  CLI  or  SHELL,  you  can  bring  up  an  editor 
to  use  on  the  file  you  are  viewing  (type  Shift-E),  if  the  EDITOR  environ- 
ment variable  is  defined.  The  EDITOR  variable  should  have  the  complete 
path  to  the  editor  specified,  i.e.  Extras:Tools/MEMACS  or  C:ED.  (For 
more  information  on  using  environment  variables,  see  the  RAM-Handler 
section  of  this  chapter  and  the  GETENV  and  SETENV  commands  in 
Chapter  2.) 

NOTE:  If  you  accidentally  press  the  Escape  key  while  using  MORE,  you 
will  be  interrupted.  To  continue,  press  either  the  "q"  or  the  "h"  key. 

PrintFiles 

With  PrintFiles  you  can  copy  files  to  your  printer  using  either  the  Work- 
bench or  the  CLI.  PrintFiles  also  accepts  multiple  filenames,  so  you  can 
designate  a  string  of  files  to  be  printed.  If  PrintFiles  cannot  find  or  open 
one  of  the  files,  it  will  skip  it  and  go  on  to  the  next  one. 

To  run  PrintFiles  from  the  CLI,  the  format  is: 

PRINTFILES  [-f]  <filename>  [[-f]  <filename>]  [[-f]  <filename>]  . . . 

The  -f  flag  turns  on  the  form  feed  mode  which  places  a  form  feed 
between  subsequent  files  and  at  the  end  of  the  file(s).  To  specify  the  form 
feed  mode  from  the  Workbench,  use  the  Workbench  menu's  INFO  item 
to  bring  up  the  PrintFiles  INFO  window.  Then  add  "FLAGS  =  formfeed" 
to  the  icon's  TOOL  TYPES. 

To  use  PrintFiles  from  the  Workbench: 

1)  Select  the  icon  of  the  first  file  you  want  to  print. 

2)  Hold  down  the  SHIFT  key  and  select  the  icons  of  any  additional 
files  you  want  to  print 

3)  Hold  down  the  SHIFT  key  and  double-click  on  the  PrintFiles 
icon. 
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GraphicDump 

GraphicDump  sends  a  dump  of  the  frontmost  Intuition  screen  to  the 
printer  about  ten  seconds  after  double-clicking  on  the  icon.  (The  ten 
second  delay  allows  you  to  rearrange  your  screens  so  that  the  frontmost 
screen  is  the  one  you  want  to  print)  There  has  been  a  change  made  to 
GraphicDump  since  the  1.2  Version;  you  can  now  specify  the  size  of  the 
resulting  printout.  To  invoke  GraphicDump  through  the  CLI,  the  format 
is: 

GraphicDump  [TINY  |  SMALL  |  MEDIUM  |  LARGE  |  xdots:ydots] 

There  are  five  options  that  determine  the  size  of  the  printout: 

TINY  The  width  of  the  resulting  printout  is  about  1/4  the  total 

width  allowed  by  the  printer.  The  height  is  such  that  the 
screen's  original  aspect  ratio  is  maintained. 

SMALL  The  width  of  the  resulting  printout  is  about  1/2  the  total 
width  allowed  by  the  printer.  The  height  is  such  that  the 
screen's  original  aspect  ratio  is  maintained. 

MEDIUM  The  width  of  the  resulting  printout  is  about  3/4  the  total 
width  allowed  by  the  printer.  The  height  is  such  that  the 
screen's  original  aspect  ratio  is  maintained. 

LARGE  The  width  of  the  resulting  printout  is  the  full  width 
allowed  by  the  printer.  The  height  is  such  that  the 
screen's  original  aspect  ratio  is  maintained.  (When  you 
run  GraphicDump  from  the  Workbench,  LARGE  is  the 
default  size  of  the  printout) 

xdots:ydots  Use  xdots  as  the  absolute  width  in  dots;  use  ydots  as  the 
absolute  height  in  dots.  This  allows  the  user  to  specify 
any  dimensions  within  the  confines  of  the  printer. 

In  order  for  GraphicDump  to  recognize  the  TINY,  SMALL,  MEDIUM  or 
LARGE  options,  the  Limits  setting  in  Preferences  must  be  set  to  Ignore 
(the  default  option).  If  a  different  option  is  chosen  in  Limits,  the  size  of  the 
resulting  printout  will  be  determined  by  the  specified  option.  The  follow- 
ing examples  assume  that  Limits  is  set  to  Ignore. 

1)  To  produce  a  printout  of  the  frontmost  screen  that  is  about  one-half 
the  total  width  allowed  by  the  printer,  you  would  type: 

1>  GRAPHICDUMP  SMALL 

2)  To  specify  the  exact  dimensions  of  the  printout,  for  instance,  if  you 
wanted  it  to  be  640  pixels  by  200  pixels,  you'd  type: 

1>  GRAPHICDUMP  640:200 
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The  Clock 

When  you  open  the  Clock,  a  170  x  90  pixel  analog  clock  will  appear. 
When  the  Clock  is  in  Analog  mode,  you  can  use  its  sizing  gadget  to  shrink 
or  enlarge  it.  This  is  the  only  mode  which  will  let  you  change  the  size  of 
the  Clock. 

If  you  prefer  a  digital  display,  you  now  have  a  choice:  Digital  1  or  Digital 
2.  Digital  1  displays  the  clock  in  a  rectangular  window  with  two  lines  — 
one  for  the  time  and  one  for  the  date,  if  desired.  Digital  2  is  a  smaller 
window  that  appears  in  the  Title  Bar  so  that  it  doesn't  obstruct  anything 
on  the  screen.  When  the  Date  option  is  turned  on,  the  time  and  date  are 
alternately  displayed  in  the  window. 

The  Alarm  works  exactly  as  it  did  before,  except  for  one  minor  detail. 
Now  when  the  Alarm  window  is  present,  the  clock  itself  remains  function- 
al. With  Version  1.2,  the  clock  would  freeze  when  the  alarm  requester 
was  displayed.  Remember  though,  you  cannot  close  the  Clock  when  the 
Alarm  is  set. 

If  you  start  the  Clock  from  the  CLI,  you  can  use  command  line  arguments 
to  specify  which  type  of  Clock  you  want.  The  format  is: 

CLOCK  [ANALOG|DIGITALl|DIGITAL2]  [  =  <x>,<y> 
[,  <width>,  <height>]J  [12HOUR|24HOUR] 
[SECONDS]  [DATE] 

The  options  are  as  follows: 

ANALOG,  DIGITAL1,  or  DIGITAL2  —  corresponds  to  the  Clock's 
Type  menu,  described  above;  default  is  ANALOG. 

=  <x>,<y>  —  allows  you  to  determine  the  placement  of  the  clock. 
The  number  assigned  to  <x>  is  equal  to  the  number  of  horizontal 
pixels  from  the  left  side  of  the  screen,  while  <y>  is  equal  to  the 
number  of  pixels  from  the  top.  The  <width>,<height>  option 
pertains  to  the  size  of  the  Analog  clock,  in  pixels.  If  this  option  is 
given  for  a  Digital  clock,  it  is  ignored.  When  you  type  this  option,  be 
sure  there  is  no  space  between  the  word  ANALOG  and  the  equals 
sign.  Default  is  =10,15. 

12HOUR  or  24HOUR  —  choose  either  a  12  hour  (AM/PM)  clock  or 
the  military  24  hour  clock;  default  is  12  hour. 

SECONDS  —  displays  the  seconds;  default  is  for  the  seconds  option 
to  be  off. 

DATE  —  displays  the  date;  default  is  for  the  date  option  to  be  off. 

For  example: 

1>  Run  Clock  ANALOG  =  10, 20, 600, 160  12H0UR  DATE 

will  display  an  analog  clock  at  screen  position  10,  20,  600  pixels  wide  by 
160  pixels  high,  in  12-hour  mode  (AM/PM  indicator),  with  the  date. 
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The  Two  RAM  Disks 


There  are  two  RAM  disks  on  the  new  Workbench.  The  standard  RAM- 
Handler  (RAM:),  for  which  a  disk  icon  automatically  appears  on  the 
Workbench  screen,  and  the  new  recoverable  ramdrive. device  (RAD:). 

The  RAM-Handler 

The  RAM-Handler,  located  in  the  Workbench's  L:  directory,  is  the  stan- 
dard RAM:  disk  that  has  been  with  the  Amiga  all  along.  This  handler 
appears  in  the  upper  right  corner  of  the  Workbench  screen  as  the  RAM 
DISK  icon.  The  Amiga  recognizes  this  "disk"  as  RAM:,  just  as  it  recog- 
nizes a  disk  in  your  internal  drive  as  dfO:.  RAM:  changes  size  depending 
on  what  is  stored  in  it.  Therefore,  it  is  always  100%  full.  As  you  add  files  it 
expands,  and  as  you  delete  files  it  shrinks. 

All  the  popular  bugs  in  the  RAM-Handler  were  fixed  in  Version  1.3.  The 
most  obvious  differences  are: 

•  The  RAM-Handler  is  now  known  as  '  'RAM  DISK' '. 

•  It  can  be  renamed  using  the  Workbench  menu's  RENAME  item. 

During  the  Workbench's  startup-sequence,  several  directories  are  created 
in  RAM:  then  assigned  the  logical  device  names  of  T:,  ENV:,  and  CLIPS:. 
RAM:'s  T:  directory  is  used  for  scripts,  while  CLIPS:  is  a  new,  alternate 
directory  for  storing  clips  from  the  clipboard,  device.  You  can  leave  these 
directories  in  RAM:  or  assign  them  elsewhere  if  you  desire. 

ENV:  is  for  storing  environment  variables  created  with  the  SETENV 
command.  You  use  SETENV  to  assign  a  *  Value' '  to  a  variable.  This  is 
not  necessarily  a  mathematical  or  numerical  value,  rather  it  is  a  variable 
string.  For  instance,  if  you  want  to  use  the  Editor  option  of  the  MORE 
program,  and  you  want  to  use  MEMACS  as  the  editing  tool,  type: 

SETENV  EDITOR  "Extras  1.3:  Tools/MEMACS" 

In  this  case  the  name  and  path  to  the  editing  program  is  the  variable 
string.  If  you  were  to  look  in  the  ENV:  directory  after  using  SETENV,  you 
would  find  a  file  called  EDITOR.  Currently,  MORE  and  the  IF  command 
use  environment  variables.  Other  commands  will  use  them  in  the  future. 

If  you  create  a  variable  with  SETENV  and  later  want  to  check  to  see  the 
string  that  you've  assigned  to  it,  use  the  GETENV  command.  Simply  type 
GETENV  followed  by  the  name  of  the  variable,  and  the  system  will 
respond  with  the  value,  or  string,  assigned  to  that  name. 

The  Recoverable  Ramdrive.  device 

A  recoverable  ramdrive  allows  you  to  access  the  contents  of  the  ram- 
drive. device  after  rebooting  your  machine.  Even  if  you  reboot  with 
something  other  than  the  Workbench  disk  (for  instance,  a  word  process- 
ing program),  the  recoverable  ramdrive  will  still  be  present  and  will  still 
hold  its  contents.  The  contents  are  not  lost  until  you  turn  the  Amiga's 
power  off  or  invoke  the  REMRAD  command. 

Just  like  a  hard  disk  or  some  other  expansion  device,  the  ramdrive  must 
be  MOUNTed  before  use.  A  sample  MountList  entry  (called  RAD:)  is 
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included  in  the  Workbench's  DEVS:  directory  MountList  file.  A  sample 
CLI  session  performing  these  operations  is  described  below: 

1>  TYPE  devs/mountlist 

Just  to  make  sure  the  entry  for  RAD:  is  in  there.  The  default  entry  has  the 
high  cylinder  set  at  21.  For  comparison  purposes,  a  standard  Amiga  disk 
has  79  cylinders.  If  you  wish  to  enlarge  the  size  of  the  device,  increase  the 
number  for  the  high  cylinder  entry. 

1>  MOUNT  rad: 

Tells  the  Amiga  that  the  recoverable  ramdrive.  device  is  in  use.  To  check 
that  you've  mounted  RAD  correctly,  use  the  INFO  command. 

1>  RELABEL  DRIVE  Rad:  NAME  MyRad 

You  can  name  the  device  anything  you  choose  except  RAM.  You  don't 
want  to  confuse  it  with  the  Workbench's  other  RAM  disk. 

l>DISKCHANGERad: 

Informs  the  Workbench  of  the  name  change  made  with  RELABEL. 

If  you  have  not  upgraded  your  computer  to  Kickstart  Version  1.3,  either 
by  using  the  new  1.3  Kickstart  disk  in  your  A1000  or  by  having  the  new 
1.3  Kickstart  ROM  installed  in  your  A500  or  A2000,  you  will  need  to 
MOUNT  RAD:  each  time  you  reboot. 

If  you  want  to  remove  RAD:  without  turning  the  entire  system  off,  you 
can  use  the  REMRAD  command.  Simply  type  REMRAD  at  a  CLI  prompt, 
and  the  RAD:  device  will  shrink.  If  you  reboot  your  machine,  RAD:  will 
not  recover. 

When  using  Kickstart  Version  1.3,  it  is  possible  to  reboot  directly  from 
RAD:  without  having  to  insert  a  Workbench,  or  other  bootable  disk,  into 
the  disk  drive.  (See  Chapter  5,  Changing  Your  Startup  Sequences.) 
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2.  AMIGADOS  AND  WORKBENCH'S  C  DIRECTORY 

This  chapter  outlines  any  changes  or  additions  made  to  the  commands  in 
the  Workbench's  C:  directory.  There  are  also  several  new  commands 
documented  in  this  section.  For  more  information  on  AmigaDOS,  consult 
The  AmigaDOS  Manual  published  by  Bantam  Books  and  available  from 
many  computer  dealers  and  bookstores. 

There  are  sixty-four  commands  in  the  Workbench's  C:  Directory: 


ADDBUFFERS 

EDIT 

JOIN 

RESIDENT 

ASK 

ELSE 

LAB 

RUN 

ASSIGN 

ENDCLI 

LIST 

SEARCH 

AVAIL 

ENDIF 

LOADWB 

SETCLOCK 

BINDDRIVERS 

ENDSKIP 

LOCK 

SETDATE 

BREAK 

EVAL 

MAKEDIR 

SETENV 

CD 

EXECUTE 

MOUNT 

SETPATCH 

CHANGETASKPRI 

FAILAT 

NEWCLI 

SKIP 

COPY 

FAULT 

NEWSHELL 

SORT 

DATE 

FF 

PATH 

STACK 

DELETE 

FILENOTE 

PROMPT 

STATUS 

DIR 

GETENV 

PROTECT 

TYPE 

DISKCHANGE 

ICONX 

QUIT 

VERSION 

DISKDOCTOR 

IF 

RELABEL 

WAIT 

ECHO 

INFO 

REMRAD 

WHICH 

ED 

INSTALL 

RENAME 

WHY 

Many  of  these  commands  are  only  used  by  programmers  and  more 
advanced  users.  However,  many  '  'average' '  users  find  AmigaDOS  very 
valuable  for  organizing  the  information  contained  on  their  disks.  For  this 
reason,  any  new  or  revised  commands  will  be  documented  here  so  that 
all  users  can  have  access  to  this  information. 

Unchanged  Commands 

These  commands  have  not  been  changed  with  the  release  of  Version  1.3 
and  are  fully  documented  in  The  AmigaDOS  Manual 

BREAK  To  set  attention  flags  in  the  specified  process. 

CD  To  set,  change,  or  list  the  current  directory. 

ED  To  edit  text  files  (a  screen  editor). 

EDIT  To  edit  text  files  by  processing  the  source  file  sequen- 
tially (a  line  editor). 

ELSE  To  have  an  alternative  in  a  conditional  in  a  script  file. 

ENDIF  To  terminate  an  IF  block  in  a  script  file. 

FAILAT  To  set  the  failure  condition  of  a  script  file. 

FAULT  To  print  the  specified  error  message(s). 

LAB  To  specify  a  label  in  a  script  file. 

MAKEDIR  To  create  a  new  directory. 

QUIT  To  exit  from  a  script  file  with  a  specified  error  code. 

RELABEL  To  change  the  volume  name  of  a  disk. 

RENAME  To  change  the  name  of  a  file  or  directory. 

SORT  To  sort  small  files. 
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STACK  To  display  or  set  the  stacksize  of  the  current  CLI. 

WAIT  To  cause  AmigaDOS  to  wait  a  specified  amount  of 

time. 
WHY  To  print  an  error  message  to  explain  why  the  previous 

command  failed. 

New  or  Revised  Commands 

Many  AmigaDOS  commands  have  been  revised  since  the  release  of 
Version  1.2,  and  others  are  not  fully  documented  in  the  available  refer- 
ence material.  These  commands  are  listed  here  using  the  standard  Ami- 
gaDOS outline:  Format,  Template,  Purpose,  Path,  and  Specification. 
Some  of  the  text  conventions  you  should  be  familiar  with  are: 

COMMAND  AmigaDOS  commands  appear  in  capital  letters  to  distin- 
guish them  from  the  rest  of  the  text. 

<  >  Angled  brackets  enclose  arguments  that  you  need  to  speci- 

fy. For  instance,  <filename>  means  that  you  must  enter  a 
specific  filename  along  with  the  AmigaDOS  command. 

[  ]  Square  brackets  enclose  options;  options  will  be  accepted 

by  AmigaDOS  but  are  not  required. 

{ }  Braces  enclose  items  that  can  be  repeated  any  number  of 

times  (or  not  at  all).  For  example,  {<args>}  means  that  a 
number  of  arguments  can  be  given  but  are  not  required. 

Three  dots  indicate  a  series  that  can  be  continued. 

|  A  vertical  bar  is  used  to  separate  a  list  of  options  of  which 

you  can  choose  one.  For  instance,  [OPT  R|S|RS]  means 
that  you  can  choose  the  R  option,  the  S  option  or  both 
(RS)  options. 

<argument>/AThe  argument  must  be  specified  in  order  for  the  com- 
mand to  work. 

<option>/K  The  option  keyword  must  be  specified,  even  if  other 
parameters  are  also  given.  For  instance,  one  of  the  options 
of  the  DIR  command  is  [OPT  A|I|  AI|D].  The  Template  is 
"OPT/K".  This  means  that  you  must  type  the  word  OPT 
when  you  specify  the  chosen  option.  Either  OPT  A,  OPT  I, 
OPT  AI,  or  OPT  D.  You  cannot  simply  type  A,  I,  AI  or  D 
alone. 

<option>/S  The  option  works  as  a  switch.  You  must  type  the  name  of 
the  option  in  order  to  specify  that  option.  For  instance,  the 
DIR  command  also  has  an  [ALL]  option.  You  must  type 
the  word  ALL  if  you  want  to  use  that  option. 

Several  of  the  command  explanations  refer  to  a  command's  condition 
flag.  A  condition  flag  is  set  when  a  command  fails  in  some  way.  A 
condition  flag  of  5  represents  a  warning  and  means  that  although  some 
sort  of  error  occurred,  it  was  not  serious  enough  to  terminate  the  process. 
Subsequent  commands  willbe  executed.  This  is  further  explained  in  the 
section  on  the  FAILAT  command  in  The  AmigaDOS  Manual. 
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ADDBUFFERS 

Format:       ADDBUFFERS  <drive>:  <nn> 

Template:    ADDBUFFERS  '  'DRIVE/^BUFFERS/A' ' 

Purpose:      To  command  the  file  system  to  add  cache  buffers. 

Path:  C:ADDBUFFERS 

Specification: 

ADDBUFFERS  adds  <nn>  buffers  to  the  list  of  sector  caches  for 
<drive>.  When  using  the  standard  file  system,  additional  buffers  can 
make  disk  access  significantly  faster.  However,  each  additional  buffer 
reduces  memory  by  approximately  500  bytes.  As  a  general  rule,  only  add 
25-30  buffers.  Disk  access  time  does  not  really  increase  by  adding  more 
than  25  or  30;  you  would  also  be  using  up  valuable  memory. 

When  using  the  FastFileSystem  with  a  hard  drive,  adding  additional 
buffers  always  speeds  up  disk  access.  (For  more  information  on  the 
FastFileSystem,  see  Appendix  A.)  The  recommended  number  of  addi- 
tional buffers  varies  depending  on  how  much  extra  memory  is  available. 

Example: 

1>  ADDBUFFERS  dfl:    25 

Adds  25  buffers  to  the  sector  caches  for  disk  drive  dfl:. 

ASK 

Format:        ASK  <prompt> 

Template:    ASK  '  'PROMPT/A ' 

Purpose:      To  obtain  user  input  when  executing  a  script  file. 

Path:  CASK 

Specification: 

ASK  writes  the  <prompt>  string  to  the  current  output  stream,  then  waits 
for  the  user's  keyboard  input.  Valid  responses  are  Y  (yes),  N  (no),  and 
RETURN  (same  as  no).  ASK  then  sets  the  condition  flag  to  5  ( =  WARN) 
if  a  YES  response  was  typed,  and  0  if  a  NO  response  was  typed.  This 
command  is  normally  only  useful  in  script  files. 

See  also:      IF,  EXECUTE 
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ASSIGN 

Format:        ASSIGN  [[<name>:]  <dir>]  [LIST]  [EXISTS]  [REMOVE] 

Template:    ASSIGN  '  {NAME,DIR,LIST/S,EXISTS/S,  REMOVE/S' ' 

Purpose:      To  assign  a  logical  device  name  to  a  file  system  directory. 

Path:  GASSIGN 

Specification: 

With  Version  1.3,  ASSIGN  will  now  print  device  names  with  more  than  3 
letters  properly.  If  the  LIST  keyword  is  given  along  with  a  logical  device 
name,  ASSIGN  will  search  the  ASSIGN  list  for  that  name  and  remove  it 
from  the  list. 

If  the  EXISTS  keyword  is  given  along  with  a  logical  device  name,  AS- 
SIGN will  search  the  ASSIGN  list  for  that  name,  and  display  the  device 
and  the  directory  assigned  to  the  device.  If  the  device  is  not  found,  the 
condition  flag  is  set  to  WARN. 

The  REMOVE  option  disconnects  a  volume  or  device  from  the  list  of 
mounted  devices.  It  does  not  free  up  resources;  it  merely  removes  the 
name  from  the  list.  THIS  OPTION  IS  PRIMARILY  USED  DURING 
SOFTWARE  DEVELOPMENT.  CARELESS  USE  OF  THIS  OPTION 
MAY  CAUSE  A  GURU  FAILURE. 

Examples: 

1>  ASSIGN  fonts:  EXISTS 
FONTS:  Workbench  1.3: fonts 

1>  ASSIGN  fonts:  LIST 

Volumes: 

RAM  Disk  [Mounted] 

Workbench  1.3  [Mounted] 

Directories: 


CLIPS: 

ENV: 

T: 

S: 

L: 

C: 

DEVS: 

LIBS: 

SYS: 


RAM  DISK: clipboards 
RAM  DISK:env 
RAM  DISK:t 
Workbench  1.3: s 


Workbench  1.3:1 
Workbench  1.3 :c 
Workbench  1.3:devs 
Workbench  1.3: libs 
Workbench  1.3:sys 


Devices: 

SPEAK  NEWCON  DF2  DFO  PRT 

PAR  SER  RAW  CON  RAM 

Note  that  the  assignment  "FONTS:  Workbench  1.3:fonts' 
removed  from  the  ASSIGN  list. 


has  been 
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AVAIL 

Format:       AVAIL  [CHIP  |  FAST  |  TOTAL] 

Template:    AVAIL  '  'CHIP/S,FAST/S,TOTAL/S" 

Purpose:      To  report  the  amount  of  available  CHIP  and  FAST  memory. 

Path:  QAVAIL 

Specification: 

The  AVAIL  command  gives  a  summary  of  the  system  RAM  memory, 
both  CHIP  and  FAST.  For  each  memory  type,  AVAIL  reports  the  total 
amount,  how  much  is  available,  how  much  is  currently  in  use,  and  the 
largest  contiguous  memory  block  not  yet  allocated. 

By  using  the  CHIP,  FAST  and/or  TOTAL  options,  AVAIL  will  display 
only  the  number  of  free  bytes  of  CHIP,  FAST  or  TOTAL  RAM  available, 
instead  of  the  complete  summary.  This  value  can  be  used  for  compari- 
sons in  scripts. 

Examples: 

1>  AVAIL 

Type  Available  In-Use  Maximum  Largest 

chip  233592  282272  515864  76792 

fast  341384  182896  524280  197360 

total  574976  465168  1040144  197360 

1>  AVAIL  CHIP 
233592 

See  Also:  EXECUTE,  IF 

BINDDRIVERS 

Format:        BINDDRIVERS 

Template:    BINDDRIVERS 

Purpose:      To  bind  device  drivers  to  hardware. 

Path:  QBINDDRIVERS 

Specification: 

BINDDRIVERS  is  normally  part  of  a  startup  sequence.  It  is  used  to  bind 
device  drivers  found  in  the  SYS:Expansion  directory  to  add-on  hardware 
that  has  been  automatically  configured  by  the  expansion  library.  What 
this  means,  is  that  if  drivers  for  expansion  hardware  are  in  the  Expansion 
drawer,  the  hardware  will  be  configured  automatically  when  the  system  is 
booted. 


Workbench's  C  Directory  2-5 


CHANGETASKPRI 

Format:        CHANGETASKPRI  <priority>  [<process>] 

Template:    CHANGETASKPRI '  'PRIORITY/A,PROCESS/K' ' 

Purpose:      To  change  the  priority  of  processes  started  from  the  CLI. 

Path:  CiCHANGETASKPRI 

Specification: 

Since  the  Amiga  is  a  multitasking  machine,  it  uses  priority  numbers  to 
determine  which  tasks  it  should  attend  to  and  in  which  order.  Normally, 
most  tasks  have  a  priority  of  0,  and  the  time  and  instruction  cycles  of  the 
CPU  are  divided  among  them.  CHANGETASKPRI  changes  the  priority 
of  the  specified  CLI  process.  (If  no  process  is  specified,  the  current  CLI 
process  is  assumed.)  Any  tasks  started  from  <process>  inherit  its  priority. 

The  range  of  acceptable  values  for  <priority>  is  -128  to  127.  However, 
you  should  not  enter  values  above  +5  to  avoid  disrupting  important 
system  tasks. 

Process  numbers  of  CLIs  can  be  determined  by  using  the  STATUS 
command. 

Example: 

1>   CHANGETASKPRI 5 

The  priority  of  the  current  CLI  task  is  changed  to  5.  Any  tasks  started 
from  this  CLI  will  also  have  a  priority  of  5.  They  will  have  priority  over 
any  other  user  tasks  created  without  using  CHANGETASKPRI  (those 
tasks  will  have  a  priority  of  0). 

See  also:      STATUS 

COPY 

Format:  COPY  [[FROM]  <name>]  [TO]  <name>  [ALL]  [QUIET] 
[BUF|BUFFER  =  <nn>][CLONE]  [DATE]  [COM] 
[NOPRO] 

Template:  COPY  ''FROM,TO/A,ALUS,QUIET/S,BUF=BUFFER/K, 
CLONE/S,DATE/S,  COM/S,  NOPRO/S" 

Purpose:      To  copy  a  file  or  directory. 

Path:  C:COPY 

Specification: 

You  can  use  COPY  to  copy  multiple  files  to  a  device.  Either  use  the  ALL 
option  to  copy  an  entire  directory,  or  use  pattern  matching  to  copy  files 
that  share  a  common  set  of  characters  or  symbols. 


2-6  Workbench's  C  Directory 


For  instance,  you  can  use  pattern  matching  to  copy  all  the  files  of  a 
directory  by  specifying  the  directory  name  as  the  pattern.  (For  a  full 
explanation  of  patterns  see  TheAmigaDOS  Manual  Note:  The  31  char- 
acter restriction  on  the  use  of  wildcards  has  been  removed.) 

The  BUF=  option  is  used  to  set  the  number  of  512  byte  buffers  used 
during  the  copy.  (Default  is  100K  or  200  buffers.)  It  is  often  useful  to  limit 
the  number  of  buffers  when  copying  to  the  RAM:  disk. 

The  CLONE  option  tells  COPY  to  copy  the  date,  comments  and  protec- 
tion bits  of  the  original  to  the  destination  file.  The  DATE  and  COM 
options  direct  COPY  to  copy  the  creation  date  and  the  comments  of  the 
original  file.  By  default,  COPY  retains  the  protection  bits  of  the  original 
file  when  it  makes  a  copy.  This  may  be  overridden  by  using  the  NOPRO 
option. 

Formerly,  if  a  directory  specified  as  the  destination  did  not  exist,  COPY 
did  not  create  one.  With  Version  1.3,  COPY  will  now  create  a  new 
destination  directory.  You  can  also  use  a  pair  of  quotes  ("")  to  refer  to 
the  current  directory  when  specifying  a  destination. 

DATE 

Format:        DATE  [<date>]  [<time>]  [TO=VER  <filename>] 

Template:    DATE  '  'DATE,TIME,TO  =  VER/K' ' 

Purpose:      To  display  or  set  the  system  date  and/or  time. 

Path:  C:DATE 

Specification: 

DATE  now  allows  either  a  leading  zero  or  a  single  digit  in  the  date 
specification.  Formerly  you  had  to  supply  the  leading  zero. 

DELETE 

Format:        DELETE  <name>*  [ALL]  [Q  |  QUIET] 

Template:    DELETE  '  'NAME(S),ALL/S,Q  =  QUIET/S' ' 

Purpose:      To  delete  up  to  10  files  or  directories. 

Path:  QDELETE 

Specification: 

You  can  use  pattern  matching  to  delete  files.  If  you  are  using  pattern 
matching,  the  31  character  restriction  on  the  use  of  wildcards  has  been 
removed.  (For  a  full  explanation  of  patterns,  see  The  AmigaDOS 
Manual. ) 
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DIR 

Format:        DIR  [<name>]  [OPT  A|I|AI|D]  [ALL]  [DIRS]  [INTER] 
[FILES] 

Template:    DIR  '  'NAME,OPT/K,ALL/S,DIRS/S,INTER/S,FILES/S' ' 

Purpose:      To  display  a  sorted  list  of  the  files  in  a  directory. 

Path:  C:DIR 

Specification: 

ALL,  DIRS,  and  INTER  are  now  synonyms  for  the  A,  D,  and  I  options, 
respectively.  In  addition,  there  is  a  COMMAND  =  option  in  interactive 
mode  (invoked  through  OPT  I  or  INTER)  which  allows  almost  any 
AmigaDOS  command  to  be  executed  during  the  interactive  directory  list. 

When  you  want  to  issue  a  general  command  in  interactive  mode,  type  C 
(or  COM)  at  the  question  mark  prompt.  DIR  will  ask  you  for  the  com- 
mand. Type  the  desired  command,  then  hit  RETURN.  The  command  will 
be  executed  and  DIR  will  continue.  You  can  also  combine  the  C  and  the 
command  on  one  line,  by  putting  the  command  in  quotes  following  the 
C.  For  instance,  C  *  'type  prefs.info  hex'  \ 

The  FILES  option  displays  only  the  files  in  a  directory;  subdirectories  are 
not  displayed. 

DISKCHANGE 

Format:        DISKCHANGE  <drive>: 

Template:    DISKCHANGE  '  'DRIVE/A' ' 

Purpose:      To  inform  the  Amiga  that  you  have  changed  a  disk  in  a  5  1/4" 
disk  drive. 

Path:  QDISKCHANGE 

Specification: 

You  must  use  the  DISKCHANGE  command  when  you  are  using  5  1/4" 
floppy  disk  drives  with  your  Amiga  system.  Whenever  you  change  the 
disks  in  the  5  1/4"  drive,  you  must  use  DISKCHANGE  to  inform  the 
system  of  the  switch. 

This  command  is  also  useful  to  inform  Workbench  of  any  name  changes 
made  to  diskettes  with  the  RELABEL  command. 

Example: 

If  a  requester  appears  and  asks  you  to  insert  a  new  disk  into  your  5  1/4" 
drive,  known  as  df2:,  you  must  insert  the  disk,  then  type: 

1>  DISKCHANGE  df2: 

AmigaDOS  will  then  recognize  the  new  disk,  and  you  can  proceed. 


2-8  Workbench's  C  Directory 


DISKDOCTOR 

Format:        DISKDOCTOR  <drive>: 

Template:    DISKDOCTOR  *  'DRIVE/A' ' 

Purpose:      To  attempt  to  repair  a  corrupt  disk. 

Path:  C:DISKDOCTOR 

Specification: 

DISKDOCTOR  attempts  to  repair  a  corrupt  floppy  disk  enough  to  allow 
you  to  retrieve  files  from  it  and  copy  them  onto  a  good  disk.  If  AmigaDOS 
detects  a  corrupt  disk,  it  displays  a  requester  stating  that  the  disk  could  not 
be  validated.  By  using  DISKDOCTOR,  you  can  try  to  restore  the  disk's 
file  structure.  After  running  DISKDOCTOR,  you  should  copy  the  restored 
files  to  another  disk,  then  reformat  the  corrupt  disk. 

You  can  use  DISKDOCTOR  on  both  the  standard  file  system  and  the 
FastFileSystem.  However,  to  use  DISKDOCTOR  with  the  FastFileSys- 
tem,  YOU  MUST  MAKE  SURE  THAT  THE  DOSTYPE  KEYWORD  IN 
THE  MOUNTLIST  IS  SET  TO  0X444F5301.  Do  NOT  use  DISKDOC- 
TOR on  a  FastFileSystem  partition  if  the  DosType  Keyword  is  not  set 
correctly.  (See  Appendix  A  for  more  information  on  the  FastFileSystem.) 

With  Version  1.3,  DISKDOCTOR  checks  for  enough  memory  before 
starting  operations  and  changes  the  boot  block  to  type  DOS. 

Example: 

If  you  receive  a  message  stating  that  *  'Volume  Workbench  is  not 
validated'  '  or  '  'Error  validating  disk/Disk  is  unread- 
able' ',  you  can  use  DISKDOCTOR  to  retrieve  the  disk's  files.  For 
instance,  if  the  corrupt  disk  is  in  dfl,  type: 

1>  DISKDOCTOR  dfl: 

AmigaDOS  will  ask  you  to  insert  the  disk  to  be  corrected  and  press 
RETURN.  DISKDOCTOR  then  reads  each  cylinder  of  the  disk.  If  it  finds 
an  error,  it  displays  '  'Hard  error  Track  xx,  Surface  xx'  '.As 
each  file  and  directory  is  replaced,  the  filename  is  displayed  on  the 
screen.  When  DISKDOCTOR  is  finished,  it  says  '  'Now  copy  files 
required  to  a  new  disk  and  reformat  this  disk.  '  ' 
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ECHO 

Format:        ECHO  <string>  [NOLINE]  [FIRST  <nn>]  [LEN  <nn>] 

Template:    ECHO  '  'STRING, NOLINE/S,FIRST/S,LEN/S' ' 

Purpose:      To  print  a  string. 

Path:  C:ECHO 

Specification: 

Version  1.3  has  introduced  the  NOLINE  option.  When  the  NOLINE 
option  is  specified,  ECHO  does  not  automatically  output  a  new  line  after 
printing  the  string. 

The  FIRST  and  LEN  options  allow  the  echoing  of  a  substring.  FIRST 
<nn>  indicates  the  character  position  to  begin  the  echo;  LEN  <nn> 
indicates  the  number  of  characters  of  the  substring  to  echo,  beginning 
with  the  first  character. 

If  the  FIRST  option  is  omitted  and  only  the  LEN  keyword  is  given,  the 
substring  printed  will  consist  of  the  rightmost  <nn>  characters  of  the 
main  string.  For  instance,  if  your  string  is  20  characters  long  and  you 
specify  LEN  <4>,  the  17th,  18th,  19th,  and  20th  characters  of  the  string 
will  be  echoed. 

ENDCLI 

Format:        ENDCLI 

Template:    ENDCLI 

Purpose:      To  end  an  interactive  CLI  process  or  a  SHELL  process. 

Path:  CiENDCLI 

Specification: 

ENDCLI  can  be  used  to  end  either  a  CLI  process  or  a  SHELL  process. 

ENDSKIP 

Format:        ENDSKIP 

Template:     ENDSKIP 

Purpose:      To  terminate  a  SKIP  block  in  a  script  file. 

Path:  C:ENDSKIP 

Specification: 

When  an  ENDSKIP  is  encountered  during  a  SKIP,  execution  of  the  script 
file  resumes  at  the  line  following  the  ENDSKIP.  (The  condition  flag  is  set 
to  WARN.) 
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EVAL 

Format:      EVAL  <valuel>   <operation>   <value2>   [TO  <file>] 
[LFORMAT=<string>] 

Template:   EVAL  "VALUE1, OPERATION, VALUE2,TO/K,LFORMAT/K'' 

Purpose:     To  provide  a  means  of  evaluating  simple  expressions. 

Path:  C:EVAL 

Specification: 

The  EVAL  command  is  used  to  evaluate,  and  to  print  the  answer  of, 
simple  (1  and  2  argument)  integer  expressions.  <valuel>  and  <val- 
ue2>  may  be  in  decimal,  hexadecimal,  or  octal  numbers.  Decimal  num- 
bers are  the  default.  Hexadecimal  numbers  are  indicated  by  either  a 
leading  OX  or  #X.  Octal  numbers  are  indicated  by  either  a  leading  0  or  a 
leading  #  (followed  by  other  digits).  Alphabetical  characters  are  indicated 
by  a  leading  single  quote  ('). 

The  supported  operations  and  their  corresponding  symbols  are  as 
follows: 


addition 

+ 

not 

~ 

subtraction 

- 

left  shift 

« 

multiplication 

* 

right  shift 

» 

division 

/ 

negation 

- 

mod 

mod 

exclusive  or 

xor 

and 

& 

bitwise  equivalence 

eqv 

or 

1 

The  output  format  defaults  to  decimal;  however,  through  use  of  the 
LFORMAT  keyword,  you  may  select  another  format.  The  LFORMAT 
keyword  specifies  the  formatting  string  used  to  print  the  answer.  You  may 
use  %X  (hexadecimal),  %0  (octal),  %N  (decimal),  or  %C  (character). 
Note  that  the  %X  and  %0  options  require  a  *  'number  of  digits' '  specifica- 
tion, (i.e.,  %X8  gives  8  digits  of  hex  output.) 

When  using  the  LFORMAT  keyword,  you  can  specify  that  a  new  line 
should  be  printed  by  including  a  *N  in  your  string. 

EVAL  can  be  used  in  scripts  to  act  as  a  counter  for  loops.  In  that  case,  the 
TO  option,  which  sends  the  output  of  EVAL  to  a  file,  is  very  useful. 
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Examples: 

l>EVAL4*-5 
-20 

l>EVAL0x4f /010LF0RMAT=I  'The  answer  is  %X4*N'  ' 
The  answer  is  9 

Example  in  a  script: 

.key  loop/a 

;  demo  a  loop  using  eval  and  skip 

.bra{ 

.ket} 

echo  >env:  loop  {loop} 

lab  start 

echo  "Loop  #"  noline 

type  enviloop 

eval  <env:loop  >NIL:  to  =  t:qwe{$$}  value2  =  l  op  =  - ? 

type  >env :  loop  t :  qwe{$$} 

IF  val  $loop  GTO 

skip  start  back 

endif 

echo  "done" 

EXECUTE 

Format:        EXECUTE  <command  file>  <arguments> 

Template:    EXECUTE  '  *COMMANDFILE,ARGUMENTS' ' 

Purpose:      To  execute  a  command  file  with  argument  substitution. 

Path:  QEXECUTE 

Specification: 

EXECUTE  now  uses  the  logical  name  T:  if  it  is  ASSIGNed;  otherwise  it 
uses  the  :T  directory. 

Since  script  files  call  on  the  EXECUTE  command,  it  is  an  excellent 
candidate  for  being  made  resident  when  using  the  SHELL. 

The  current  CLI  number  can  be  referenced  by  the  characters  <$$>.  This 
is  useful  in  creating  unique  temporary  files,  logical  assignments,  and  PIPE 
names. 

See  Also:    ASSIGN,  and  the  SHELL-SEG  section  of  Chapter  3. 
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FF 

Format:        FF  [-0]  [-N] 

Template:    FF  "-0/S,-N/S" 

Purpose:      To  speed  up  text  on  the  Amiga. 

Path:  C:FF 

Specification: 

FF  (FastFonts)  is  a  program  written  by  Charlie  Heath,  of  Microsmiths,  Inc. 
FF  speeds  up  the  display  of  text  on  the  Amiga.  To  turn  on  the  FastText 
routines,  use  the  -0  option.  To  turn  off  the  FastText  routines,  use  the  -N 
option,  FF  can  also  be  used  to  replace  the  default  system  font  with  a  plain 
8x8  pixel  font.  Use  the  command:  FF  <fontname>. 

FF  is  used  by  permission  of  Microsmiths,  Inc. 

FILENOTE 

Format:        FILENOTE  [FILE]  <filename>  COMMENT  <comment> 

Template:    FILENOTE  '  'FILE/A,COMMENT/K' ' 

Purpose:      To  attach  a  comment  to  a  file. 

Path:  OFILENOTE 

Specification: 

The  length  of  <comment>  is  limited  to  79  characters. 

GETENV 

Format:        GETENV  <name> 

Template:    GETENV  '  'NAME/A' ' 

Purpose:      To  get  the  value  of  an  environment  variable. 

Path:  QGETENV 

Specification: 

GETENV  is  used  to  get  the  value  of  an  environment  variable.  Environ- 
ment variables  are  stored  in  the  ENV:  handler.  (Currently,  this  is  simulat- 
ed by  using  the  RAM:  disk.) 

You  can  use  many  AmigaDOS  commands  with  the  ENV:  handler,  such 
as  DIR,  LIST,  ASSIGN,  etc.  This  gives  users  great  flexibility  in  working 
with  environment  variables. 

See  also:      SETENV 
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ICONX 

Format:        ICONX 

Template:    ICONX 

Purpose:      To  execute  an  AmigaDOS  script  file  from  Workbench. 

Path:  C:ICONX 

Specification: 

ICONX  allows  you  to  execute  a  script  file  of  AmigaDOS  commands  from 
the  Workbench.  ICONX  changes  the  current  directory  to  the  directory 
containing  the  project  icon  before  executing  the  script  An  input/output 
window  for  the  script  file  is  opened  on  the  Workbench  screen.  You  can 
use  the  icon's  TOOL  TYPES  to  specify  the  size  of  the  window  (WIN- 
DOW = ).  The  DELAY  =  TOOL  TYPES  will  add  a  short  delay  after  the 
execution  of  the  file  is  complete  to  allow  time  for  reading  the  output.  If  a  0 
is  specified  for  DELAY  = ,  ICONX  waits  for  a  Control-C  before  exiting. 

To  use  ICONX,  create  a  script  file  (an  ASCII  file  containing  AmigaDOS 
commands),  and  attach  a  project  icon  to  it.  (Notepad  can  be  used  for  this 
purpose,  as  long  as  you  do  not  use  styles  and  multiple  fonts  in  your 
document).  Using  the  Workbench  INFO  menu  item,  change  the  default 
tool  of  the  icon  to  cICONX.  Add  the  WINDOW  =  and  DELAY  =  TOOL 
TYPES  specifications  if  you  choose.  Then  save  the  changed  info.  To 
execute  the  script,  double -click  on  the  icon. 

You  can  work  through  the  Workbench  and  use  extended  selection  to 
pass  Workbench  files  to  the  script.  These  files  appear  to  the  script  as 
keywords.  To  use  this  facility,  the  .key  keyword  must  be  at  the  start  of  the 
script.  In  this  case,  the  AmigaDOS  EXECUTE  command  is  used  to 
execute  the  script  file.  Adding  a  .key  ""  or  .<space>  allows  the  use  of 
commands  that  require  input  in  an  ICONX  script.  (See  The  AmigaDOS 
Manual  for  more  information  on  executing  script  files.) 

See  Also:     EXECUTE 

IF 

Format:        IF  [NOT]  [WARN]  [ERROR]  [FAIL]  [<string>  EQ|GT|GE 
<string>]  [VAL]  [EXISTS  <file>] 

Template:    IF '  <NOT/S,WARN/S,ERROR/S,FAIL/S„EQ/K,GT/K,  GE/K, 
VAL/S,  EXISTS/K" 

Purpose:      To  handle  conditional  operations  in  script  files. 

Path:  GIF 

Specification: 

In  an  EXECUTE  script  file,  IF  carries  out  all  subsequent  commands  until 
an  ENDIF  or  ELSE  command  is  found. 

IF  now  supports  the  GT  (greater  than)  and  GE  (greater  than  or  equal  to) 
comparisons.  Normally,  the  comparisons  are  performed  as  string  com- 
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parisons.  However,  if  the  VAL  option  is  specified,  the  comparison  is  a 
numeric  comparison. 

The  IF  command  can  evaluate  environment  variables.  To  specify  an 
environment  variable,  the  variable's  name  is  prefaced  with  a  $  character. 

NOTE:  You  can  use  NOT  GE  for  LT  and  NOT  GT  for  LE. 

For  more  information  on  the  IF  command,  see  TheAmigaDOS  Manual. 

INFO 

Format:        INFO  [ <device> ] 

Template:    INFO  '  'DEVICE' ' 

Path:  C:INFO 

Purpose:      To  give  information  about  the  file  system(s). 

Specification: 

INFO's  output  now  adjusts  to  allow  longer  volume  names.  INFO  reads 
reserved  blocks  from  the  environment  vector  of  the  specified  device. 

The  DEVICE  option  allows  INFO  to  provide  information  on  just  one 
device  or  volume. 

INSTALL 

Format:        INSTALL  DRIVE   <DF0|DF1|DF2|DF3>:   [NOBOOT] 
[CHECK] 

Template:    INSTALL  '  'DRIVE/A,NOBOOT/S,CHECK/S' ' 

Path:  C:INSTALL 

Purpose:      To  handle  the  boot  block  of  a  formatted  disk. 

Specification: 

INSTALL  now  clears  memory  used  to  build  boot  block.  The  NOBOOT 
option  makes  the  disk  a  DOS  disk,  but  not  bootable.  The  CHECK  option 
checks  against  valid  boot  code.  INSTALL  reports  if  a  disk  is  bootable,  or 
not,  and  whether  standard  Commodore-Amiga  boot  code  is  present  on 
the  disk.  The  condition  flag  is  set  to  0  if  the  boot  code  is  standard  (or  the 
disk  isn't  bootable),  5  ( =  WARN)  otherwise. 

NOTE:  INSTALL's  NOBOOT  option  will  write  the  boot  block  on  a  non- 
DOS  disk. 
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JOIN 

Format:        JOIN  <name>  <name>*  AS|TO  <name> 

Template:    JOIN  '  'NAME(S),TO = AS/K' ' 

Purpose:      To  concatenate  up  to  15  files  to  make  a  new  file. 

Path:  C:JOIN 

Specification: 

TO  is  now  a  synonym  for  AS. 

LIST 

Format:  LIST  [<dir| pattern >]  [P|PAT  <pattern>]  [KEYS] 
[DATES]  [NODATES]  [TO  <name>]  [SUB  <substring>] 
[SINCE  <date>]  [UPTO  <date>]  [QUICK]  [BLOCK] 
[NOHEAD]  [FILES]  [DIRS]  [LFORMAT  <string>] 

Template:    LIST  '  'DIR,P  =  PAT/K,KEYS/S,DATES/S,NODATES/S, 
TO/K ,  SUB/K ,  SINCE/K ,  UPTO/K ,  QUICK/S ,  BLOCK/S, 
NOHEAD/S,  FILES/S,  DIRS/S,  LFORMAT/K' ' 

Purpose:      To  list  specified  information  about  directories  and  files. 

Path:  C:LIST 

Specification: 

LIST  now  displays  the  new  protection  bits:  s  (script),  p  (pure  —  used  with 
the  RESIDENT  command),  and  a  (archive). 

When  searching  for  a  pattern,  you  can  specify  a  search  string  within  a 
directory.  For  example,  to  search  for  a  pattern  within  the  C:  directory, 
you  could  type  LIST  C:l#?.  This  would  result  in  a  display  of  all  the  files  in 
the  C:  directory  that  start  with  the  letter  1. 

The  LIST  options  are  as  follows: 

QUICK  extra  spaces  are  not  output  after  each  filename 

BLOCK  LIST  displays  file  sizes  in  blocks,  rather  than  bytes 

NOHEAD       suppresses  the  printing  of  the  header  information 

FILES  limits  LIST  to  displaying  files  only  (no  directories) 

DIRS  limits  LIST  to  displaying  directories  only  (no  files) 

LFORMAT  modifies  the  output  of  LIST  and  can  be  used  as  a  quick 
method  of  generating  script  files.  When  LFORMAT  is  specified,  the 
QUICK  and  NOHEAD  options  are  automatically  selected.  When  using 
LFORMAT  you  must  specify  an  '  'output  format  specification' '  string;  this 
string  is  incorporated  into  the  script  file.  Also,  if  you  want  the  output  to  be 
saved,  you  must  redirect  it  to  a  file  by  using  the  >  command. 
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The  format  for  the  output  format  specification  string  (hereafter  referred  to 
as  '  'string' ')  is  LFORMAT=' 'string''.  To  include  the  output  of  LIST  in 
this  string,  you  can  specify  a  %S  substitution.  The  path  and  filename  can 
also  be  part  of  this  string.  The  number  of  occurrences  of  the  %S  deter- 
mines the  type  of  output  to  be  included  in  the  string,  as  follows. 


Number  of  %S 
1 


3 
4 


Output 
filename  only 

path,  filename 

path,  filename,  path 

path,  filename,  path,  filename 


Example: 

1>  LIST  >RAM:qwe  #?  LF0RMAT  =  "protect  %S  -d" 

A  new  script  file  '  'qwe' '  is  created  in  RAM:.  The  contents  will  include  a  list 
of  all  the  files  in  the  current  directory.  When  "qwe"  is  executed,  it  will 
remove  the  delete  protection  from  each  file.  For  instance,  the  contents 
may  look  like  this: 

protect  Expansion. info  -d 
protect  Trashcan  -d 
protect  .info  -d 
protect  c  -d 
protect  Clock. info  -d 
protect  Prefs  -d 
protect  Clock  -d 
protect  System  -d 
protect  L  -d 
protect  Shell  -d 
protect  devs  -d 
protect  S  -d 
protect  Shell. info  -d 
protect  T  -d 
protect  fonts  -d 
protect  libs  -d 
protect  Empty  -d 
protect  Utilities. info  -d 
protect  Disk. info  -d 
protect  Prefs. info  -d 
protect  System. info  -d 
protect  Empty. info  -d 
protect  Trashcan. info  -d 
protect  Utilities  -d 
protect  Expansion  -d 
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LOADWB 

Format:       LOADWB  [DELAY]  [-DEBUG] 

Template:    LOADWB  '  'DELAY/S,-DEBUG/S' ' 

Purpose:      To  start  Workbench. 

Path:  CLOADWB 

Specification: 

The  LOADWB  command  is  used  to  start  the  Workbench.  Normally,  this 
is  only  done  when  booting,  by  placing  the  LOADWB  command  in  the 
startup-sequence  file. 

Workbench  snapshots  the  current  paths  in  effect  when  the  LOADWB 
command  is  executed.  It  uses  these  paths  for  each  CLI  (or  SHELL) 
started  from  Workbench. 

If  the  DELAY  option  is  specified,  LOADWB  waits  three  seconds  before 
exiting.  This  allows  disk  activity  to  stop  before  execution  continues. 

The  -DEBUG  option  tells  Workbench  to  bring  up  a  hidden  Workbench 
menu  —  DEBUG.  This  menu  contains  the  menu  items  Debug  and 
FlushLibs.  The  Debug  item  breaks  you  into  ROMWACK,  the  Amiga's 
ROM-resident  debugger,  so  you  must  have  a  9600  baud  serial  terminal 
attached  if  you  intend  to  use  this  command!  FlushLibs  causes  Workbench 
to  attempt  to  allocate  as  much  memory  as  possible,  so  that  any  libraries, 
devices,  fonts,  etc.,  resident  in  memory  but  not  currently  in  use  will  be 
expunged.  (Assuming  that  the  particular  library  or  device  allows  itself  to 
be  expunged.) 

Both  the  DELAY  and  -DEBUG  options  cannot  be  used  at  the  same  time. 
You  can  only  choose  one  or  the  other. 

LOCK 

Format:        LOCK  <drive>:  [ON  |  OFF]  [<passkey>] 

Template:    LOCK  '  'DRIVE/A, ON/S,OFF/S,PASSKEY' * 

Purpose:      To  set  the  write  protect  status  of  a  hard  disk  using  the 
FastFileSystem. 

Path:  CLOCK 

Specification: 

The  LOCK  command  sets  or  unsets  the  write  protect  status  of  a  hard  disk 
drive  or  partition  mounted  using  the  FastFileSystem.  The  LOCK  remains 
on  until  the  system  is  rebooted  or  until  the  LOCK  is  turned  off  with  the 
LOCK  OFF  command.  An  optional  4  character  passkey  may  be  speci- 
fied. If  the  passkey  is  used  to  lock  a  hard  disk  partition,  the  same  passkey 
must  be  specified  to  unlock  the  partition. 

See  Also:     The  section  on  the  FastFileSystem  in  Appendix  A. 
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MOUNT 

Format:        MOUNT  <device>  [FROM  <file>] 

Template:    MOUNT  '  'DEVICE/A,FROM/K' ' 

Purpose:      To  create  an  AmigaDOS  device  node. 

Path:  C:MOUNT 

Specification: 

MOUNT  is  used  to  create  an  AmigaDOS  device  node.  In  other  words, 
MOUNT  informs  the  Amiga  that  an  additional  device  has  been  added  to 
the  system.  When  the  MOUNT  command  is  issued,  MOUNT  looks  in  the 
DEVS:MountList  file  (or  the  optional  FROM  file)  for  the  parameters  of  the 
device  that  is  being  mounted. 

See  Also:     The  section  on  MountLists  in  Chapter  3. 

NEWCLI 

Format:        NEWCLI  [<window  specification^]  [FROM  <filename>] 

Template:    NEWCLI 4  'WINDOW,FROM/K' ' 

Purpose:      To  start  a  new  interactive  CLI  with  a  new  window. 

Path:  ONEWCLI 

Specification: 

NEWCLI  uses  the  default  startup  file,  s:CLI-Startup  unless  another  file  is 
specified  with  the  FROM  option. 

If  you  want  to  invoke  a  SHELL,  instead  of  a  CLI,  use  the  NEWSHELL 
command. 

NEWSHELL 

NEWSHELL    [<window    specification^    [FROM 
<filename>] 

NEWSHELL '  4WINDOW,FROM/K' ' 

C:NEWSHELL 

To  start  a  new  interactive  SHELL  with  a  NEWCON  window. 


Format: 

Template: 

Path: 

Purpose: 

Specification: 

NEWSHELL  invokes  a  new,  interactive  SHELL,  using  the  NEWCON: 
window  handler.  For  NEWSHELL  to  work  properly,  NEWCON:  must  be 
mounted  first  and  the  SHELL-SEG  must  be  made  resident.  (This  is 
normally  done  in  1.3's  default  startup-sequence.) 

If  the  SHELL-SEG  has  not  been  made  resident,  NEWSHELL  will  invoke 
a  new  CLI  window  instead  of  a  new  SHELL  window.  If  NEWCON:  has 
not  been  mounted,  NEWSHELL  will  use  a  CON:  window. 

NEWSHELL  uses  the  default  startup  file  s:Shell-Startup,  unless  a  FROM 
filename  is  specified. 
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PATH 

Format:        PATH  [SHOW]  [ADD  <directory>*]  [RESET]  [QUIET] 

Template:    PATH  '  'SHOW/S,ADD,RESET/S,QUIET/S' ' 

Purpose:      To  control  the  PATH  list  that  the  CLI  uses  to  search  for 
commands. 

Path:  C:PATH 

Specification: 

The  PATH  command  lets  you  see,  add,  or  change  the  search  path  that 
AmigaDOS  follows  when  looking  for  a  program  to  execute.  Enter  the 
PATH  command  alone,  or  with  the  SHOW  option,  and  the  current  path 
will  be  displayed. 

Use  PATH  with  the  ADD  option  to  specify  directory  names  to  be  added 
to  the  current  PATH.  You  can  add  up  to  ten  directories  with  one  PATH 
ADD  command;  names  of  the  directories  must  be  separated  by  at  least 
one  space,  and  the  ADD  keyword  is  optional. 

To  replace  the  existing  search  path  with  a  completely  new  one,  use  PATH 
RESET,  followed  by  the  names  of  the  directories.  The  existing  search 
path,  except  for  the  current  directory  and  SYS:C,  is  erased  and  the  new 
one  is  substituted. 

When  the  QUIET  flag  is  specified,  PATH  searches  the  paths  quietly 
(when  SHOWing)  —  without  displaying  requesters  for  unmounted  vol- 
umes. If  a  volume  is  unmounted,  only  the  volume  name  will  be  dis- 
played; PATH  will  not  list  the  directories. 

PROMPT 

Format:        PROMPT  <prompt> 

Template:    PROMPT  '  'PROMPT ' 

Path:  OPROMPT 

Purpose:      To  change  the  prompt  string  of  the  current  SHELL. 

Specification: 

Prompt  can  print  the  current  directory  automatically  when  used  with  the 
SHELL.  For  example: 

%N>  displays  only  the  CLI  number 

%N.%S>     displays  the  CLI  number,  a  period,  then  the  current 

directory 
%S.%N>     displays  the  current  directory,  a  period,  then  the  CLI 

number 

See  Also:     The  SHELL  section  of  Chapter  1,  and  the  SHELL-SEG 
section  of  Chapter  3. 
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PROTECT 

Format:        PROTECT  [FILE]  <filename>  [FLAGS]  <  +  -  status  bits> 
[ADD]  [SUB] 

Template:    PROTECT  '  'FILE/A,FLAGS,ADD/S,SUB/S' ' 

Purpose:      To  change  the  protection  bits  of  a  file. 

Path:  PROTECT 

Specification: 

PROTECT  can  now  change  the  new  protection  bits,  script  (s),  pure  (p), 
and  archive  (a).  In  addition,  PROTECT  can  be  used  to  add  or  subtract 
protection  bits  to  or  from  a  file,  rather  than  just  setting  specific  bits.  The 
keywords  ADD  and  SUB,  as  well  as  the  special  flags  +  and  - ,  are  used 
for  this  purpose.  Use  the  LIST  command  to  display  the  protection  bits  of 
files. 

Examples: 

1>  PROTECT  c:  ED  +rw 

adds  the  protection  bits  r  (readable)  and  w  (writable)  to  the  file  '  'ED* '  in 
the  C:  directory. 

1>  PROTECT  1 :  filename  -e 

deletes  the  e  (executable)  protection  bit  from  the  file  '  Rename' '  in  the  L: 
directory. 

See  Also:     LIST 

REMRAD 

Format:        REMRAD 

Template:    REMRAD 

Purpose:      To  remove  the  recoverable  ramdrive.  device. 

Path:  C:REMRAD 

Specification: 

If  you  want  to  remove  the  recoverable  ramdrive.  device  from  the  system, 
but  you  do  not  want  to  turn  the  system's  power  off,  you  can  use  the 
REMRAD  command.  REMRAD  commands  the  ramdrive.  device  to  delete 
all  of  its  files.  The  device  also  decreases  its  size  and  becomes  very  small. 
The  next  time  the  Amiga  is  rebooted,  the  ramdrive.  device  is  removed 
from  the  system. 
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RESIDENT 

Format:       RESIDENT  <Resident  Name>  <File>  [REMOVE]  [ADD] 
[REPLACE]  [PURE]  [SYSTEM] 

Template:    RESIDENT    "NAME,FILE,REMOVE/S,ADD/S,REPLACE/S, 
PURE/S,SYSTEM/S,, 

Purpose:      To  load  and  add  commands  to  the  resident  list. 

Path:  GRESIDENT 

Specification: 

RESIDENT  is  used  to  load  commands  and  add  them  to  the  resident  list 
maintained  by  the  SHELL.  This  allows  the  command  to  be  executed 
without  it  having  to  be  reloaded  each  time,  resulting  in  faster  execution 
and  reduced  memory  usage  when  multitasking.  This  is  only  available 
when  using  the  SHELL. 

Only  certain  commands  can  be  made  resident  The  command  should  be 
both  reentrant,  meaning  that  it  can  be  used  by  two  or  more  independent 
programs  at  the  same  time,  and  re-executable.  Commands  that  have 
these  characteristics  have  the  pure  bit  set  in  the  protection  field.  Many  of 
the  commands  in  the  C:  directory,  as  well  as  the  MORE  command  in 
Utilities,  are  PURE  commands  and  can  be  made  resident  If  a  command 
does  not  have  its  pure  bit,  it  probably  can't  be  made  resident  safely. 

The  REPLACE  option  is  the  default  option  and  does  not  need  to  be 
explicitly  stated.  If  RESIDENT  is  invoked  with  no  options,  or  with  the 
REPLACE  option,  it  lists  the  programs  on  the  resident  list  If  a  <resident 
name>  is  specified  and  RESIDENT  finds  a  program  with  that  name 
already  on  the  list,  it  will  attempt  to  replace  the  command.  The  replace- 
ment will  succeed  only  if  the  already  resident  command  is  not  in  use.  If  no 
<resident  name>  is  specified  (i.e.,  just  a  filename  is  specified)  RESI- 
DENT will  use  just  the  filename  portion  as  the  name  on  the  resident  list. 

Note:  The  full  pathname  to  the  file  must  be  used. 

If  the  SYSTEM  option  is  specified,  the  command  will  be  added  to  the 
system  portion  of  the  resident  list.  Any  commands  added  to  the  resident 
list  with  the  SYSTEM  option  cannot  be  removed.  To  list  SYSTEM  files  on 
the  RESIDENT  list,  you  must  specify  the  SYSTEM  option. 

The  PURE  option  forces  RESIDENT  to  load  commands  which  are  not 
marked  as  pure  (i.e.,  they  do  not  have  their  pure  bit  set),  and  can  be  used 
to  experimentally  test  the  pureness  of  other  commands  and  programs. 
PLEASE  USE  THIS  OPTION  WITH  CAUTION.  Remember  that  in  order 
for  a  command  to  be  made  RESIDENT,  it  must  be  both  reentrant  and  re- 
executable.  Although  it  is  unlikely,  some  of  your  programs  may  be  pure 
enough  to  be  fully  reentrant  and  usable  by  more  than  one  process  at  the 
same  time.  Other  programs  may  not  be  fully  reentrant  but  may  be  pure 
enough  to  be  re-executable.  Such  commands  can  be  made  RESIDENT, 
but  you  must  be  extremely  careful  to  only  use  the  command  in  one 
process  at  a  time. 
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If  you  are  going  to  experiment  with  the  PURE  option,  be  sure  to  boot  with 
a  standard,  write-protected  Workbench  disk,  one  that  has  never  been 
altered  in  any  way.  Do  not  use  directories  on  or  assign  directories  to  a 
hard  disk.  Open  a  SHELL  window  and  CD  to  RAM:  or  RAD:.  While  you 
are  experimenting,  make  sure  that  any  files  you  read  or  write  are  in 
RAM:,  RAD:  or  on  a  backup  or  freshly  formatted  floppy  disk.  Then  make 
the  program  you  are  testing  RESIDENT,  by  typing: 

1>  RESIDENT  filename  PURE 

To  test  if  a  program  is  re-executable,  run  the  program  from  the  SHELL, 
use  as  many  of  the  program's  functions  as  you  can,  then  exit  the  pro- 
gram. Run  the  program  a  second  time,  calling  it  up  with  different  com- 
mand line  options,  if  possible.  It  is  possible  that  the  program  will  crash  at 
this  point,  meaning  that  it  is  definitely  not  re-executable.  If  the  program 
works,  examine  all  of  the  things  that  the  program  usually  remembers 
during  a  session,  for  instance,  command  line  options,  checked  menu 
selections,  search  strings,  names  of  last  loaded  or  saved  files,  etc.  If  the 
program  remembers  things  from  the  previous  session,  it  is  not  re-execut- 
able. If  the  program  settings  are  fresh,  keep  trying  as  many  options  as  you 
can  to  make  sure  that  they  still  work  properly.  If  the  program  appears  to 
be  working  well,  it  can  probably  be  used  as  a  resident  command  by  one 
process  at  a  time. 

To  test  if  a  program  is  fully  reentrant,  open  a  second  SHELL,  CD  to 
RAM:,  and  try  running  the  resident  program  from  both  SHELLS  at  the 
same  time.  Test  all  the  program  options,  always  checking  both  running 
programs  to  make  sure  that  the  options  selected  in  one  SHELL  are  not 
affecting  the  program  in  the  other  SHELL.  If  the  program  loads  or  saves 
files,  thoroughly  test  the  load/save  options  in  both  programs  at  the  same 
time.  Check  the  loaded/saved  files  to  make  sure  that  they  are  not  incom- 
plete or  corrupt.  At  this  point  you  may  feel  confident  that  you  can  safely 
use  the  program  as  a  resident  command.  But,  if  you  do,  be  alert  for  file 
problems  and  improper  behavior. 

See  Also:     PROTECT  and  the  SHELL-SEG  section  of  Chapter  3. 
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RUN 

Format:        RUN  <command>  [+  <comment>] 

Template:    RUN  '  'COMMAND' ' 

Purpose:      To  execute  commands  as  background  processes. 

Path:  C:RUN 

Specification: 

RUN  may  now  be  used  to  launch  background  processes  which  do  not 
prevent  the  closing  of  the  CLI  in  which  the  process  was  started.  To  do 
this,  redirect  the  output  of  RUN  to  NIL:  by  using  the  >  symbol.  However, 
if  for  some  reason  the  program  you  are  running  gets  a  lock  on  '  '*' '  (the 
current  window),  you  still  will  not  be  able  to  close  that  window. 

Commands  that  are  RUN  may  come  from  the  commands  stored  on  the 
resident  list.  For  speed,  resident  commands  are  checked  before  com- 
mands in  the  command  path. 

When  used  to  start  a  new  CLI,  RUN  sets  things  up  so  the  new  CLI  will  use 
a  default  startup  file:  s:Shell-Startup,  if  the  Shell  is  in  operation,  or  s:CLI- 
Startup,  if  the  Shell  is  not  operative. 

Example: 

1>  RUN  >NIL:   sample  program 

redirects  the  output  of  the  sample  program  to  the  NIL:  device. 

SEARCH 

Format:       SEARCH  FROM  <name><pattern>  [SEARCH]  <string> 
[ALL]  [NONUM]  [QUIET]  [QUICK]  [FILE] 

Template:    SEARCH    '  'FROM,SEARCH/A,ALL/S,NONUM/S. 
QUIET/S,QUICK/S,FILE/S' ' 

Purpose:      To  look  for  the  specified  text  string  in  the  specified  files. 

Path:  OSEARCH 

Specification: 

Search  now  returns  a  0  if  the  object  is  found,  and  a  5  (=WARN) 
otherwise.  This  makes  it  more  useful  in  scripts.  Search  stops  searching 
when  a  Control-C  is  typed. 

The  options  are  as  follows: 

NONUM    SEARCH  does  not  print  line  numbers  with  the  strings 

QUIET      SEARCH  searches  '  'quietly' ';  no  output  is  displayed 

QUICK      SEARCH  uses  a  more  compact  output  format 

FILE  SEARCH  will  look  for  a  file  by  the  specified  name,  rather 

than  for  a  string  in  the  file 

NOTE:  The  31  character  restriction  on  the  use  of  wildcards  has  been 
removed. 
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SETCLOCK 

Format:       SETCLOCK  LOAD  |  SAVE  |  RESET 

Template:    SETCLOCK  '  'LOAD/S,SAVE/S,RESET/S,  * 

Purpose:      To  set  or  read  the  real  time  clock. 

Path:  QSETCLOCK 

Specification: 

This  command  is  used  to  set  the  time  and  date  of  the  real  time  clock  from 
the  current  system  time  (the  SAVE  option),  or  to  set  the  current  system 
time  from  the  real  time  clock  (the  LOAD  option).  When  the  SAVE  option 
in  Preferences  is  used,  Preferences  sets  both  the  real  time  clock  and  the 
current  system  time.  The  RESET  option  is  used  to  completely  reset  the 
clock.  This  may  be  necessary  if  a  wild  program  turns  the  clock  off  or  sets 
the  test  bit  of  the  clock. 

SETDATE 

Format:       SETDATE  <file>  <date>  <time> 

Template:    SETDATE  '  'FILE/A,DATE,TIME' ' 

Purpose:      To  change  the  date  and  time  of  a  file  or  directory. 

Path:  QSETDATE 

Specification: 

The  input  for  SETDATE  has  been  relaxed,  so  that  the  output  of  the 
DATE  command  may  be  used  as  input.  SETDATE  also  does  not  need  a 
leading  0  when  specifying  the  date.  SETDATE  <file>  does  a  'touch' — it 
changes  the  date/time  of  the  file  to  the  current  system  date/time. 

See  Also:     DATE 

SETENV 

Format:        SETENV  <variable  name>  <variable  string> 

Template:    SETENV  '  'NAME/A^TRING' ' 

Purpose:      To  set  an  environment  variable. 

Path:  QSETENV 

Specification: 

SETENV  is  used  to  set  or  remove  the  value  of  an  environment  variable. 
Environment  variables  are  stored  in  the  ENV:  handler  (currently,  this  is 
the  RAM:  disk). 

To  remove  an  environment  definition,  use  SETENV  <variable  name>. 
The  variable  will  remain  in  ENV:,  but  it  will  be  empty. 
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Examples: 

1>  SETENV  Editor  "Extras  1 .3  :Tools/MEMACS" 

creates  the  environment  variable  '  'EDITOR' '  which  can  be  used  with  the 
MORE  utility.  This  specifies  the  editor  as  being  MEMACS  which  is  located 
in  the  Tools  drawer  of  the  Extras  disk. 

1>  SETENV  Editor  C:ED 

same  as  above,  only  the  editor  specified  is  the  AmigaDOS  Editor  ED. 

See  Also:     GETENV  and  the  Section  on  the  ENV:  handler  in  Chapter  1. 

SETPATCH 

Format:        SETPATCH  [R] 

Template:    SETPATCH  "R/S" 

Purpose:      To  make  ROM  patches  in  Version  1.2  and  Version  1.3 
Kickstarts. 

Path:  QSETPATCH 

Specification: 

Both  Version  1.2  and  Version  1.3  Kickstart  ROMs  have  a  few  known 
bugs  that  are  fixed  by  running  SETPATCH.  SETPATCH  must  be  run  in 
the  first  line  of  the  startup-sequence  file,  as  is  done  in  the  startup- 
sequence  file  of  Version  1.3  Workbench.  SETPATCH  patches  Display- 
AlertQ,  the  68000  math  exception  vectors,  the  graphic  library  Delete- 
Layersf)  routine,  and  the  AllocEntryO  Exec  function. 

The  R  option  is  used  to  protect  the  recoverable  ramdrive.  device  on 
systems  with  1  megabyte  of  CHIP  RAM.  This  is  necessary  since  Version 
1.3  Kickstart  is  designed  to  work  with  512K  of  CHIP  RAM. 

See  Also:     Chapter  5,  Changing  Your  Startup  Sequences 

SKIP 

Format:        SKIP  <label>  [BACK] 

Template:    SKIP  '  'LABEL, BACK/S' ' 

Purpose:      To  skip  ahead  when  executing  command  files. 

Path:  C:SKIP 

Specification: 

When  the  BACK  option  is  used,  SKIP  starts  searching  for  the  specified 
label  at  the  beginning  of  the  file.  Without  the  BACK  option,  SKIP  starts 
the  search  at  the  current  line  of  the  file.  This  allows  backwards  SKIPs. 
You  can  only  SKIP  back  as  far  as  the  last  EXECUTE  statement.  If  there 
are  no  EXECUTE  statements  in  a  script,  you  can  SKIP  back  to  the 
beginning  of  the  file. 
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STATUS 

Format:       STATUS  <process>  [FULL]  [TCB]  [CLI|ALL]  [COM- 
MAND] 

Template:    STATUS    'PROCESS,FULL/S,TCB/S,CLI=ALL/S,COM- 
MAND/K" 

Purpose:      To  list  information  about  the  CLI/SHELL  processes. 

Path:  QSTATUS 

Specification: 

STATUS  now  supports  negative  priorities.  With  the  new  COMMAND 
option,  you  can  tell  STATUS  to  search  for  a  command.  STATUS  then 
scans  the  CLI  list  looking  for  that  command.  If  the  command  is  found,  the 
CLI  number  is  printed,  and  the  condition  flag  is  set  to  0.  Otherwise  the 
flagissetto5(=WARN). 

This  is  useful  in  script  files.  For  example,  to  send  a  BREAK  to  the  process 
executing  the  ClockPtr  command,  the  sequence  is: 

1>  STATUS  >ram:qwe  COMMAND  =  ClockPtr 
BREAK  <ram:qwe  >NIL:    ? 

See  Also:     BREAK 

TYPE 

Format:       TYPE    <from>    [TO    <name>]    [OPT   H  =  HEX| 
N  =  NUMBER] 

Template:    TYPE  '  cFROM/A,TO/S,OPT/K,HEX/S,NUMBER/S' ' 

Purpose:      To  type  a  text  file. 

Path:  C:TYPE 

Specification: 

TYPE  now  checks  to  see  if  a  destination  file  exists  and  complains  if  it 
does,  unless  the  TO  option  is  specified  explicitly. 

The  OPT  H  and  OPT  N  options  are  now  available  by  the  HEX  and 
NUMBER  keywords,  respectively. 
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VERSION 

Format:       VERSION  <library  name | device  name>  [<version  #>] 
[<revision  #>]  [<unit  #>] 

Template:    VERSION  c  'NAME,VERSION,REVISION,UNrr ' 

Purpose:      To  find  the  version  and  revision  numbers  of  a  Workbench 
disk. 

Path:  CiVERSION 

Specification: 

VERSION  is  used  to  find  the  version  and  revision  number  of  a  library, 
device,  or  the  Workbench  disk.  VERSION  can  also  test  for  a  specific  ver- 
sion/revision, and  set  the  condition  flag  if  the  version/revision  is  greater. 

VERSION  with  no  <library  name  |  device  name>  argument  prints  the 
Kickstart  version  number  and  the  Workbench  version  number.  If  a  li- 
brary name  |  device  name>  is  specified,  version  attempts  to  open  the 
library  or  device  and  read  the  version  information. 

When  a  <version  #>  (and  possibly  a  <revision  #>)  is  specified,  VER- 
SION will  set  the  condition  flag  to  0  if  the  version  (and  revision)  numbers 
of  the  Workbench  disk,  library,  or  device  are  greater  than  or  equal  to  the 
specified  values.  Otherwise,  the  flag  is  set  to  5  ( = WARN).  (If  a  revision 
number  is  not  specified,  no  comparison  on  the  revision  number  is 
performed.) 

In  the  case  of  using  VERSION  on  the  Workbench  disk  itself,  the  first  value 
is  the  Kickstart  version;  the  second  is  the  Workbench  version.  You  cannot 
use  the  VERSION  command  with  a  path  name  to  check  on  the  version  of 
a  device. 

The  <unit  #>  option  allows  you  to  specify  a  unit  number  other  than  0. 
This  is  occasionally  necessary  for  accessing  multi-unit  devices. 

See  Also:     IF,  EXECUTE 

WAIT 

Format:       WAIT  <n>  [SEC|SECS]  [MIN|MINS]  [UNTIL  <time>] 

Template:    WAIT  '  \SEC  =  SECS/S,  MIN  =  MINS/S,UNTIL/K' » 

Purpose:      To  wait  for  the  specified  time. 

Path:  C:WAIT 

Specification: 

WAIT  now  allows  a  leading  zero  when  specifying  the  wait  period. 
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WHICH 

Format:       WHICH  <filename>  [NORESJ  [RES] 

Template:    WHICH  '  'FILE/A,NORES/S,RES/S, ' 

Purpose:      To  search  the  command  path  for  a  particular  command. 

Path:  GWHICH 

Specification: 

WHICH  lets  you  find  a  particular  command  by  returning  the  location  of 
that  command.  Normally,  WHICH  searches  the  resident  list,  the  current 
directory,  the  command  path(s),  and  the  C:  directory.  If  the  file  is  not 
found,  the  condition  flag  is  set  to  WARN. 

If  the  NORES  option  is  specified,  the  resident  list  will  not  be  searched.  If 
the  RES  option  is  specified,  only  the  resident  list  will  be  searched. 

Examples: 

1>  WHICH  avail 
C:  avail 
1>WHICHC: 
RAMWB : C 
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Formats  of  Unchanged  Commands 

BREAK 

Format:        BREAK  <process>  [ALL  |  C  |  D  |  E  |  F] 

Template:    BREAK  '  <PROCESS/A,ALL/S,C/S,D/S,E/S,F/S, ' 

Purpose:      To  set  attention  flags  in  the  specified  process. 

Path:  QBREAK 

CD 

Format:        CD  <directory> 

Template:    CD  "DIR" 

Purpose:      To  set,  change,  or  list  the  current  directory. 

Path:  C:CD 

ED 

Format:        ED  [FROM]  <filename>  [SIZE  <n>] 

Template:    ED  '  TROM/A,SIZE' ' 

Purpose:      To  edit  text  files  (a  screen  editor). 

Path:  C:ED 

EDIT 

Format:       EDIT  [FROM]   <filename>   [[TO]  <filename>]  [WITH 
<filename>]  [VER  <filename>]  [OPT  <option>] 


Template: 

EDIT  'TROM/A,TO,WITH/K,VER/K,OPT/K" 

Purpose: 

To  edit  text  files  by  processing  the  source  file  sequenl 
line  editor). 

Path: 

C:EDIT 

ELSE 

Format: 

ELSE 

Template: 

ELSE 

Purpose: 

To  have  an  alternative  in  a  conditional  in  a  script  file. 

Path: 

C:ELSE 

ENDIF 

Format: 

ENDIF 

Template: 

ENDIF 

Purpose: 

To  terminate  an  IF  block  in  a  script  file. 

Path: 

C:ENDIF 
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FAILAT 

Format:        FAILAT  <n> 

Template:    FAILAT '  'RCLIM" 

Purpose:      To  set  the  failure  condition  of  a  script  file. 

Path:  QFAILAT 

FAULT 
Format:        FAULT  <error  number> 
Template:    FAULT",,,,,,,,,," 
Purpose:      To  print  the  specified  error  messages(s). 
Path:  OFAULT 

LAB 
Format:        LAB  <string> 
Template:    LAB  "STRING" 
Purpose:      To  specify  a  label  in  a  script  file. 
Path:  C:LAB 

MAKEDIR 
Format:        MAKEDIR  <dir> 
Template:    MAKEDIR '  'DIR/A" 
Purpose:      To  create  a  new  directory. 
Path:  QMAKEDIR 

QUIT 
Format:        QUIT  <return  code> 
Template:    QUIT"RC 

Purpose:      To  exit  from  a  script  file  with  a  specified  error  code. 
Path:  C:QUIT 

RELABEL 
Format:        RELABEL  DRIVE  <drive>:  NAME  <name> 
Template:    RELABEL  '  'DRIVE/A,NAME/A' ' 
Purpose:      To  change  the  volume  name  of  a  disk. 
Path:  C-.RELABEL 
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RENAME 

Format:        RENAME  [FROM]  <narrie>  [TO|AS]  <name> 

Template:    RENAME  *  'FROM/A,TO = AS/A ' 

Purpose:      To  change  the  name  of  a  file  or  directory. 

Path:  QRENAME 

SORT 

Format:       SORT  [FROM]  <filename>  [TO]  <filename>   [COL- 
START  <n>] 

Template:    SORT  '  'FROM/A,TO/A,COLSTART/K' ' 

Purpose:      To  alphabetically  sort  each  line  of  a  small  file. 

Path:  C:SORT 

STACK 

Format:        STACK  [<n>] 

Template:    STACK  « 'SIZE' ' 

Purpose:      To  display  or  set  the  stack  size  of  the  current  CLI. 

Path:  GSTACK 

WHY 

Format:        WHY 

Template:    WHY 

Purpose:      To  print  an  error  message  to  explain  why  the  previous 
command  failed. 

Path:  C:WHY 
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3.  OTHER  WORKBENCH  DIRECTORIES 

In  addition  to  the  AmigaDOS  commands  explained  in  Chapter  2,  there 
are  many  other  programs  and  files  included  on  the  Workbench  disk  to 
help  you  maximize  your  computing  and  programming  efforts.  For  in- 
stance, there  are  script  files  in  the  S:  directory  that  let  you  add  wildcard 
capabilities  to  many  of  the  AmigaDOS  commands.  The  MountList  file  in 
the  DEVS:  directory  informs  the  Amiga  of  the  characteristics  of  peripher- 
als and  expansion  devices  you  may  add  to  your  system. 

This  chapter  covers  files  included  in  the  Workbench's  DEVS:,  L:,  S:  and 
LIBS:  directories.  Some  of  the  files  are  new,  while  others  have  been 
revised  with  the  release  of  Version  1.3.  Some  prior  knowledge  of  the 
Amiga  is  assumed.  Novice  users  may  want  to  consult  additional  reference 
materials  in  order  to  fully  comprehend  these  tools.  Seasoned  users  of  the 
Amiga  will  want  to  read  this  chapter  thoroughly  for  both  new  and  revised 
information. 


Devices 


The  DEVS:  directory  contains  .device  files,  such  as  the  ramdrive. device, 
the  printer,  device,  the  serial,  device,  etc.  Many  of  these  files  correspond  to 
actual  physical  devices,  such  as  peripherals  attached  to  the  Amiga's  ports 
(i.e.,  serial. device  controls  communications  through  the  serial  port  while 
the  parallel,  device  controls  the  flow  of  information  through  the  parallel 
port,  usually  to  a  printer).  This  section  does  not  explore  all  of  these  files. 
They  are  covered  in  other  reference  works,  such  as  the  ROM  Kernel 
Manuals  published  by  Addison-Wesley.  This  section  does  cover  the 
MountList,  which  many  users  need  to  become  familiar  with  when  they 
install  expansion  devices  in  their  Amiga,  and  a  new  assignment  called 
CLIPS:  which  is  used  by  the  clipboard,  device. 

The  MountList 

Found  in  the  DEVS:  directory,  the  MountList  contains  the  descriptions  of 
devices  that  are  to  be  mounted  with  the  AmigaDOS  MOUNT  command. 
You  may  need  a  MountList  entry  for  a  device,  handler,  or  file  system. 
When  you  add  a  new  device  to  your  Amiga  system,  such  as  a  hard  disk  or 
even  some  external  disk  drives,  you  must  make  the  Amiga  aware  of  the 
existence  of  the  device.  To  do  this  you  use  the  MOUNT  command.  But 
the  MOUNT  command  must  read  a  MountList  entry  in  order  to  deter- 
mine the  characteristics  of  the  device. 

Several  sample  MountList  entries  are  already  included  in  the  MountList 
file  in  the  DEVS:  directory.  Some  of  these  can  be  used  as  they  are,  but  it 
is  always  a  good  idea  to  double-check  the  file  to  make  sure  it  accurately 
corresponds  with  your  device. 

A  MountList  entry  consists  of  a  number  of  keywords  describing  the 
device,  handler,  or  file  system,  as  well  as  values  for  those  keywords. 
Some  keywords  may  only  apply  to  a  file  system  or  a  handler.  If  a 
keyword  is  omitted,  a  default  value  is  used.  You  should  always  check  the 
default  value  in  case  it  is  not  appropriate  for  whatever  you  are  mounting. 
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There  are  certain  rules  for  creating  a  MountList  entry: 

•  Each  entry  in  the  MountList  must  start  with  the  name  of  the 
device. 

•  Keywords  are  followed  by  an  equals  sign  ( = ). 

•  Keywords  must  be  separated  by  a  semi-colon  or  by  placing  them 
on  their  own,  individual  line. 

•  Comments  are  allowed  in  standard  C  style  (i.e.,  comments  start 
with  /*  and  end  with  */). 

•  Each  entry  must  end  with  the  #  symbol,  on  a  line  of  its  own. 

The  Keywords  supported  by  MOUNT  are  as  follows: 

KEYWORD  FUNCTION 

Handler  =  A  handler  entry  (i.e.,  Handler  =  L:Newcon- 

Handler) 
FileSystem=  A  file  system  entry  (i.e.,  FileSystem  =  L:Fast- 

FileSystem) 
Device  =  A  device  entry  (i.e.,  Device  =  ramdrive. device) 

Priority  =  The  priority  of  the  process;  5  is  good  for 

handlers,  10  for  file  systems 
Unit  =  The  unit  number  of  the  device 

Flags  =  Flags  for  OpenDevice  (usually  0) 

Surfaces  =  The  number  of  surfaces 

BlocksPerTrack  =  The  number  of  blocks  per  track 

Reserved  =  The  number  of  blocks  for  the  boot  block; 

should  be  2 
PreAlloc  =  The  number  of  blocks  reserved  from  the  end  of 

a  partition;  used  with  a  few  hard  drives  that 

store  information  in  the  last  few  blocks  of  a 

drive.  This  is  usually  set  to  0  and  probably  will 

not  need  to  be  changed.  Please  refer  to  the 

documentation  packaged  with  your  hard  drive 

and  hard  drive  controller. 
Interleave  =  Interleave  value;  varies  with  the  device 

LowCyl  =  Starting  cylinder  to  use 

HighCyl  =  Ending  cylinder  to  use 

Stacksize  =  Amount  of  stack  to  allocate  to  the  process 

Buffers  =  Number  of  initial  cache  buffers 

BufMemType  =  Memory  type  used  for  buffers;  (0  and  1  =  Any, 

2  and  3  =  CHIP,  4  and  5  =  FAST) 
Mount  =  If  a  positive  value,  MOUNT  loads  the  device  or 

handler  immediately  rather  than  waiting  for  first 

access 
MaxTransfer=  The  maximum  number  of  blocks  transferred; 

used  with  the  FastFileSystem 
Mask=  Address  Mask  to  specify  memory  range  that 

DMA  transfers  can  use;   used  with  the 

FastFileSystem 
GlobVec  =  A  global  vector  for  the  process;  -1  is  no  Global 

Vector  (for  C  and  assembler  programs),  0  sets 

up  a  private  GV;  if  the  keyword  is  absent,  the 

snared  Global  Vector  is  used 


3-2 


Other  Workbench  Directories 


Startup  =  A  string  passed  to  the  device,  handler,  or  file 

system  on  startup  as  a  BPTR  to  a  BSTR 

BootPri  =  A  value  which  sets  the  boot  priority  of  a  boot- 

able and  mountable  device,  such  as  the 
recoverable  ramdrive.  device.  This  value  can 
range  from  -129  to  127.  By  convention,  -129 
indicates  that  the  device  is  not  bootable  and  is 
not  automatically  mounted;  this  value  should 
be  included  for  a  recoverable  ramdrive  used 
with  the  FastFileSystem. 

DosType=  Indicates  the  type  of  file  system.  If  the 

FastFileSystem  is  used,  DosType  should  be  set 
to  0x444F5301.  Otherwise,  the  DosType 
should  be  0x444F5300.  Or,  you  could  simply 
omit  it  altogether.  It  is  possible  that  other  values 
may  be  used  in  the  future. 

Sample  MountList  entries  are  included  in  the  MountList  file.  Usually  if 
you  need  to  create  a  new  MountList,  you  will  be  given  instructions  in  the 
documentation  that  accompanies  the  device  you  are  mounting.  There  are 
also  several  MountList  examples  in  this  chapter  accompanying  the  de- 
scriptions of  the  various  handlers. 

The  Clipboard.device 

One  change  that  occurred  with  Version  1.3  which  affects  the  clipboard 
.device  is  the  advent  of  the  CLIPS:  assignment  CLIPS:  allows  you  to 
specify  an  alternate  directory  for  storing  clips  from  the  clipboard.device. 
The  Workbench's  startup-sequence  assigns  CLIPS:  to  RAM: clipboards; 
however,  you  can  re-assign  it  if  you  wish. 


Keymaps 


Keymaps  is  a  subdirectory  of  DEVS:  (devs/keymaps).  As  mentioned  in 
the  section  on  SetMap  in  Chapter  1,  the  Workbench's  keymaps  directory 
only  contains  the  usal  keymap.  International  keymaps  are  available  in 
the  devs/keymaps  directory  of  the  Extras  disk: 


KEYMAP  FILE 

:               KEYBOARD  IT  R 

cdn 

French  Canadian 

chl 

Swiss  French 

ch2 

Swiss  German 

d 

German 

dk 

Danish 

e 

Spanish 

f 

French 

gb 

British 

i 

Italian 

is 

Icelandic 

n 

Norwegian 

s 

Swedish 

usa2 

Dvorak 
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To  use  an  international  keymap: 

1)  Copy  the  keymap  file  to  the  DEVS:keymaps  directory.  For 
example: 

COPY  "Extras  1.3:  devs/keymaps/d"  to  devs :  keymaps 

2)  Use  the  SetMap  program  (in  the  System  drawer)  to  inform  the  system 
of  the  change. 

SETMAP d 

If  you  want  to  use  a  different  keymap  on  a  regular  basis,  cor/  the  file  to 
DEVS:keymaps  and  change  the  SetMap  assignment  in  the  Workbench's 
startup-sequence  by  using  a  text  editor  such  as  ED  or  MEMACS. 


The  Workbench's  FONTS:  directory  contains  the  standard  Amiga  fonts: 
Diamond,  Emerald,  Garnet,  Opal,  Ruby,  Sapphire,  and  Topaz  (the  de- 
fault font).  A  quick  way  to  see  the  different  fonts  is  to  open  a  Notepad 
window,  type  a  test  sentence,  and  then  go  through  the  font  menu 
selecting  the  different  fonts.  Each  time  you  select  a  font,  the  text  in  the 
Notepad  window  will  change. 

The  Extras  disk  also  has  a  fonts  directory  which  contains  three  new  fonts: 
Courier,  Helvetica  and  Times.  To  use  the  new  fonts,  you  must  either: 

1)  Copy  one  or  all  of  them  to  your  Workbench  disk  using  the  Amiga- 
DOS  COPY  command.  For  instance, 

COPY  "Extras  1 .3 : fonts/Times"  to  "Workbench 
1.3: fonts" 

After  copying  any  fonts  to  your  Workbench  disk,  you  should  use  the 
FixFonts  program  (in  the  System  drawer)  to  update  the  FONTS: 
directory.  Or, 

2)  ASSIGN  FONTS:  to  the  fonts  directory  of  the  Extras  disk: 
ASSIGN  FONTS :  "Extras  1.3:  fonts" 

Now  if  you  were  to  open  a  Notepad  window,  you  could  choose  Times  (if 
you  followed  example  1)  or  from  Helvetica,  Courier  and  Times  (if  you 
followed  the  second  example).  These  fonts  can  be  used  with  various 
software  programs,  such  as  many  word  processors,  which  let  you  add  or 
change  fonts.  When  using  these  new  fonts,  please  keep  in  mind  that 
Helvetica  and  Times  are  both  proportional  fonts,  while  Courier  is  a  fixed 
width  font.  * 


Handlers 


Several  new  handlers  are  located  in  the  Workbench's  L:  directory.  Most 
handlers  are  treated  as  if  they  are  actual  physical  devices  and  are  referred 
to  in  the  same  format  as  a  disk  drive.  For  instance,  RAM:  signifies  the 
RAM-Handler  which  emulates  an  actual  disk.  SPEAK:  represents  the 
Speak-Handler  which  provides  speech  output  for  the  Amiga.  Handlers 
even  control  the  appearance  of  the  windows  on  your  display  (CON:  and 
NEWCON:). 
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The  information  in  this  section  may  be  slightly  repetitive  of  material 
covered  elsewhere  in  this  manual.  For  instance,  the  characteristics  of  the 
Newcon-Handler  were  mentioned  in  the  SHELL  section.  However,  for 
your  convenience,  full  explanations  of  the  new  handlers  will  be  given 
here. 

Aux-Handler 

The  Aux-Handler  provides  unbuffered  serial  input  and  output.  It  is  basi- 
cally a  console  handler  that  uses  the  serial  port  rather  than  the  Amiga 
screen  and  keyboard. 

The  MountList  entry  is: 

AUX:       Handler  =  L:Aux-Handler 
Stacksize  =  1000 
Priority  =  5 

# 

A  sample  entry  is  already  in  the  MountList  file. 

You  can  use  Aux-Handler  to  use  another  terminal  with  your  computer. 
For  example: 

1>M0UNT  AUX: 
1>NEWCLI  AUX: 

WARNING:  The  Aux-Handler  allows  you  to  issue  multiple  NEWSHELL/ 
NEWCLI  commands.  However,  keyboard  data  from  the  aux  unit  will  be 
distributed  across  the  multiple  CLIs.  To  end  one  of  two  SHELLs  assigned 
to  AUX:,  you  must  type: 

1>E  N  D  C  L  Kspace>  <RETURN> 
You  must  put  a  space  between  each  of  the  letters  and  after  the  final  "I". 
If  you  want  to  copy  a  file  over  the  serial  port,  type: 

1>C0PY  AUX:    to  RAM:testfile 

Newcon-Handler 

The  Newcon-Handler  acts  as  a  replacement  for  the  CON:  handler,  and  is 
referred  to  in  use  by  the  name  NEWCON:.  Like  the  other  new  handlers,  it 
must  be  mounted  before  use.  This  is  generally  done  by  a  command  in  the 
Startup-Sequence  file.  (Workbench  Version  1.3  does  include  such  a 
command  in  its  startup  sequence.) 

The  entry  in  the  MountList  file  is: 

NEWCON:     Handler  =  L:  Newcon-Handler 
Priority  =  5 
StackSize  =  1000 

# 

A  NEWCON:  window  allows  users  much  more  flexibility  when  entering 
commands.  Unlike  a  CON:  window  which  only  permits  '  'straight' '  typ- 
ing, a  NEWCON:  window  allows  the  user  to  manipulate  the  text.  The 
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SHELL  is  an  example  of  a  NEWCON:  window  in  action.  A  list  of  a 
NEWCON:  window's  capabilities  follows. 

1)  Command  line  editing 

The  left  and  right  cursor  keys  are  used  to  move  through  the  command 
line.  The  Backspace  key  deletes  the  character  to  the  left  of  the  cursor; 
the  Delete  key  deletes  the  character  underneath  the  cursor. 

Some  other  editing  commands  are: 

Control-K       Deletes  everything  from  the  cursor  forward  to  the 

end  of  the  line. 
Control-U       Deletes  everything  from  the  cursor  backward  to  the 

start  of  the  line. 
Control-X       Deletes  the  entire  line. 
Control-W      Moves  the  cursor  to  the  next  tab  stop. 
Shift-Cursor  Left  (or  Control-A)  brings  the  cursor  to  the  start  of  the 
line.  Shift-Cursor  Right  (or  Control-Z)  brings  the  cursor  to  the  end  of 
the  line. 

2)  History  buffer 

NEWCON:  has  a  2K  circular  history  buffer.  Previous  commands  can 
be  retrieved  by  using  the  up  cursor  key.  (The  down  cursor  key  moves 
you  down  through  the  history  buffer;  this  is  useful  if  you  go  past  the 
command  you  are  looking  for). 

Shift-Cursor  Up  (or  Control-R)  searches  back  through  the  history 
buffer  for  the  last  command  that  matches  a  partially  typed  string. 
Shift-Cursor  Down  (or  Control-B)  brings  you  to  the  bottom  of  the 
history  buffer. 

3)  Control  characters 

Control  characters  are  displayed  by  NEWCON:  as  reversed  charac- 
ters. The  characters  are  read  as  Control  characters,  and  can  be  used  in 
files  just  as  before. 

Pipe-Handler 

PIPE:  is  an  AmigaDOS  handler  written  by  Matt  Dillon. 

The  Pipe-Handler  is  an  I/O  mechanism  used  to  provide  input/output 
communication  between  programs.  It  essentially  creates  an  interprocess 
communication  channel.  When  the  pipe  is  written  to,  up  to  4K  bytes  of 
data  are  buffered  before  the  writing  process  is  blocked.  After  you  write  to 
a  PIPE:,  other  processes  can  read  the  data. 

Like  the  other  handlers,  it  must  be  mounted.  The  MountList  entry  for 
PIPE:  is  as  follows: 

PIPE:      Handler  =  L:  Pipe-Handler 
Stacksize  =  6000 
Priority  =  5 
GlobVec  =  -1 
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PIPE:  may  be  used  from  other  programs,  like  a  word  processor  (as  a 
filename  during  a  save  operation  )  or  a  terminal  program  (as  a  capture 
buffer  filename).  You  can  use  any  rendezvous  name  you  wish.  PIPE:  uses 
a  4K  internal  buffer  per  name,  but  its  optimal  situation  is  one  in  which 
there  is  a  pending  read  and  a  pending  write.  In  this  case  it  copies  directly 
from  one  process  to  the  other,  rather  than  going  through  its  internal 
buffer.  This  is  a  true  PIPE:,  therefore,  the  source  and  destination  pro- 
cesses must  be  distinct  (i.e.  not  the  same  process)  in  order  to  prevent 
lockout  situations. 

The  buffer  is  transparent.  This  means  that  data  written,  no  matter  how 
little  it  is,  is  immediately  available  to  be  read  by  the  other  process. 

The  PIPE:  device  can  be  useful  when  you're  using  two  application 
programs  and  want  to  transfer  huge  amounts  of  data  from  one  (write)  to 
the  other  (read)  without  using  a  temporary  file  in  RAM:  or  on  disk. 
Assuming  the  application  does  not  attempt  a  Seek(),  you  simply  specify 
'PIPE: name'  and  it  looks  like  an  ordinary  file  to  the  application. 

For  those  terminal  programs  which  do  not  use  asynchronous  writes,  you 
can  fix  the  jerkiness  in  CAPTURE  by  capturing  to  a  PIPE:  and  having 
another  COPY  command  running  from  the  PIPE:  to  a  file. 

You  can  also  copy  information  from  one  PIPE:  to  another.  For  example: 

CLI  window  1 :  COPY  hugefile  PIPE:a 

CLI  window  2:  COPY  PIPE:a  PIPE:b 

CLI  window  3:  COPY  PIPE:b  PIPEx 

CLI  window  4:  COPY  PIPEx  PIPE:d 

CLI  window  5:  COPY  PIPE:d  PIPE:e 

CLI  window  6:  wordcount  PIPE:e  (or  something  similar) 

Speak-Handler 

The  Speak-Handler  provides  speech  output  for  the  Amiga.  With  SPEAK: 
you  can  literally  have  the  Amiga  '  'read' '  the  contents  of  a  file  to  you. 

Just  as  most  of  the  other  handlers,  SPEAK:  must  be  mounted  before  use. 
The  MountList  entry  is: 

SPEAK:  Handler  =  L:Speak-Handler 
Stacksize  =  4000 
Priority  =  5 
GlobVec  =  -1 

# 

In  addition  to  the  MountList  entry,  SPEAK:  also  requires  the  narrator,  de- 
vice and  translator,  library.  They  must  be  in  DEVS:  and  LIBS:  respective- 
ly. (These  files  are  included  on  Workbench  Version  1.3  in  the  appropriate 
directories.) 

The  format  for  using  SPEAK:  is: 

SPEAK:OPT/K 
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After  the  OPT  keyword,  the  following  options  may  be  used.  The  options 
must  be  separated  by  a  slash  (/)  and  there  should  be  no  space  between 
the  colon  and  OPT: 

p###  pitch  (where  ###  is  from  65-320) 

s###  speed  (where  ###  is  from  30-400) 

m  male  voice 

f  female  voice 

r  robot  voice 

n  natural  voice 

00  do  not  allow  these  options  in  the  input  stream 

01  allow  these  options  in  the  input  stream 
aO  rum  off  direct  phoneme  mode 

al  turn    on    direct   phoneme    mode    (do    not   use 

translator,  library) 
dO  break  up  sentences  on  punctuation  alone 

dl  break  up  sentences  on  punctuation,  RETURN,  and 

LINEFEED 

SPEAK:  may  be  used  from  other  programs,  like  a  word  processor  (as  a 
filename  during  a  save  operation  )  or  a  terminal  program  (as  a  capture 
buffer  filename)  to  get  spoken  output. 

For  example,  to  listen  to  the  contents  of  your  startup-sequence  file,  type: 

1>  MOUNT  SPEAK: 

1>  COPY  s:startup-sequence  to  SPEAK: OPT/f/sl60 

The  contents  of  the  startup-sequence  will  be  read  in  a  female  voice  at  a 
moderate  speed. 

SHELL-SEG 

SHELL-SEG  is  the  program  which  controls  the  new  SHELL.  SHELL- 
SEG  is  not  executed  directly.  Instead,  the  RESIDENT  command  is  used 
to  invoke  it,  under  the  name  CLI.  Once  started,  each  new  SHELL  started 
either  from  the  NEWSHELL  command  or  the  SHELL  icon  will  be  a 
SHELL  CLI,  rather  than  a  normal  CLI.  Normally  the  SHELL-SEG  is 
invoked  in  the  startup  sequence. 

The  SHELL  provides  many  additional  features  that  a  standard  CLI  does 
not  Those  features  were  explored  in  the  SHELL  section  of  Chapter  1, 
such  as  resident  commands,  aliases,  the  prompt  features,  and  the  use  of 
scripts. 

Scripts 

There  are  some  new  script  files  in  the  Workbench's  S:  directory.  These 
files  can  be  used  with  other  commands  to  expedite  your  programs: 

SPAT —  uses  the  LIST  command  to  add  pattern  matching  to 
single  argument  commands.  This  can  be  used  with  the 
SHELL'S  alias  function.  For  example,  to  display  all  of  the 
script  files  that  begin  with  the  letter  '  's' '  in  the  Work- 
bench's S:  directory,  you  could  type: 
1>  SPAT  MORE  s :  start#? 
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A  script  file  would  be  generated,  similar  to  the  one  below: 

more  "s:SPAT" 

more  us: Startup-Sequence. hdM 

more  us: Shell-Startup" 

more  us: Startup-Sequence" 

more  "s:StartupII" 
SPAT  would  then  execute  this  script  file  and  display  each 
of  the  files  consecutively. 

DPAT —  uses  the  LIST  command  to  add  pattern  matching  to 
double  argument  commands.  This  can  be  used  with  the 
SHELL'S  alias  function.  The  following  example  assumes 
that  you  have  a  series  of  files  called  Chapterl,  Chapter2, 
Chapter3,  etc.,  in  the  root  directory  of  the  disk  in  dfO;.  If 
you  wanted  to  rename  these  files  to  a  new  directory 
called  Book,  you'd  type: 

l>MAKEDIRdfO:BOOK 

1>  DPAT  RENAME  dfO:Chap#?  dfO:book 
A  script  file  is  created  to  rename  each  of  the  files  starting 
with  Chap.  DPAT  will  then  execute  that  file  and  rename 
each  of  the  Chap  files  to  the  new  BOOK  directory. 

PCD  —  similar  to  the  AmigaDOS  CD  command,  but  it  remem- 
bers the  last  directory.  For  example,  typing: 

1>PCDRAM: 

1>PCD 
will  return  you  to  the  starting  directory. 


Libraries 


There  are  new  IEEE  libraries  included  in  the  LIBS:  directory  of  the 
Version  1.3  Workbench  disk:  mathieeedoubtrans.  library  and  mathieee- 
doubbas.  library.  These  new  libraries  can  take  advantage  of  a  68881 
coprocessor,  if  available.  They  can  also  use  a  peripheral  math  chip; 
however,  the  chip  must  be  supplied  with  the  appropriate  software  to 
inform  the  system  of  the  chip's  presence  and  to  handle  the  saving  and 
restoring  of  the  chip's  status  during  task  switching. 
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4.  PRINTER  DRIVERS 

Version  1.3  supports  more  printer  drivers  than  Version  1.2;  however,  all 
the  drivers,  except  Generic,  have  been  put  on  the  Extras  disk.  This  leaves 
more  room  on  the  Workbench  disk,  while  still  supplying  the  Amiga  user 
with  a  wide  range  of  alternatives  when  it  comes  to  choosing  a  printer. 

A  printer  driver  acts  as  a  translator  for  the  computer.  The  Amiga  has  one 
way  of  encoding  information,  but  a  printer  may  have  a  different  way  of 
deciphering  that  code.  The  printer  driver  takes  the  information  from  the 
Amiga  and  reworks  it  so  that  the  printer  interprets  it  correctly. 

Printer  drivers  are  located  in  the  devs/printers  directory  of  the  Extras  disk. 
To  move  a  driver  to  your  Workbench  disk,  either  use  the  InstallPrinter 
utility  (explained  in  Chapter  1)  or  the  AmigaDOS  COPY  command  as 
illustrated  below: 

COPY  "Extras  1.3:  devs/printers/<name>"  to 
devs: printers 

After  the  file  is  copied,  the  driver  will  now  appear  in  the  list  of  supported 
drivers  that  is  displayed  in  the  Change  Printer  window  in  Preferences. 

The  various  printer  drivers  included  with  Version  1.3  are: 


EpsonXOld 

Generic* 

Howtek  Pixelmaster 

HP  DeskJet 

HP  LaserJet  (includes 

HP  LaserJet  Plus  and 

HP  LaserJet  II 

compatible) 
HP  PaintJet 
HPThinkJet 


Imagewriter  II 
NEC  Pinwriter 
Okidata  92 
Okidata  2931 
Okimate  20 
Quadram  QuadJet 
Qume  LetterPro  20 
Toshiba  P351C 
Toshiba  P351SX 
Xerox  4020 


Alphacom  AlphaPro  101 
Brother  HR-15XL 
CalComp  ColorMaster 
CalComp  ColorMaster2 
Canon  PJ-1080A 
CBM  MPS1000 
Diablo  630 

Diablo  Advantage  D25 
Diablo  C-150 
Epson  Q 
Epson  X 

♦Included  on  the  Workbench  disk. 

Specifications  about  each  of  these  drivers  are  listed  later  in  this  chapter. 
Also  included  is  information  on  the  Seiko  5300  and  5300a  and  the 
Tektronix  4693D  and  4696  printer  drivers.  While  these  drivers  are  not 
included  on  disk,  they  are  compatible  with  the  Amiga  and  are  available 
from  the  manufacturer  or  in  the  listings  topic  of  the  Amiga  Developers 
(amiga.dev)  Conference  on  BIX,  Byte's  Electronic  Information  Ex- 
change. 

Before  listing  the  drivers,  some  of  the  general  information  applicable  to 
graphic  printing  is  explained.  Before  proceeding  with  this  section  of  the 
manual,  please  read  through  the  section  on  Preferences,  in  Chapter  1,  for 
details  on  color  correction,  smoothing,  multiple  densities,  and  changing 
the  size  of  the  printout. 
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Graphic  Printing 


The  Amiga  is  world-famous  for  its  graphic  capabilities.  However,  if  you 
can't  get  the  graphics  off  the  screen  and  onto  paper,  you  are  limiting  your 
applications.  Whether  it's  a  company  newsletter,  engineering  drawings, 
or  simply  a  home-made  greeting  card,  if  you  can't  print  out  what's  on  the 
screen,  you  can't  distribute  your  work.  The  Amiga  is  capable  of  support- 
ing several  printers  —  from  a  basic  daisy-wheel  printer  that  only  prints 
black-and-white  text  to  a  sophisticated,  thermal-transfer  color  printer. 

Speed 

The  drivers  on  Version  1.3  are  approximately  five  to  30  times  faster  than 
with  Version  1.2.  The  speed  increase  is  dependent  on  the  type  of  printer 
you  are  using,  the  number  of  colors  you  are  printing  (black-and-white, 
gray-scale  or  color),  the  amount  of  white-space  in  the  picture,  the  aspect 
of  the  picture  (vertical  or  horizontal),  and  the  actual  printer  driver.  Print- 
ing speed  is  now  more  closely  related  to  the  printer  or  the  software 
program  as  opposed  to  the  computer  itself. 

Color  Printing 

HAM  Pictures  —  A  HAM  (hold-and-modify)  picture  is  one  where  any- 
where from  32  colors  to  the  Amiga's  full-range  of  4,096  colors  are 
displayed.  Previously,  you  could  only  print  a  HAM  picture  starting  at  an  x 
position  of  0  (corresponding  to  the  top,  left  corner  of  the  paper).  Now, 
you  can  start  printing  at  any  valid  x  position.  It  is  also  possible  to  print 
inverted  HAM  pictures. 

Below  are  some  things  to  keep  in  mind  when  performing  screen  dumps. 

For  better  qualify  screen  dumps: 

•  On  most  printers,  friction  fed  paper  tends  to  produce  better  look- 
ing graphic  dumps  than  tractor  fed  paper.  You  wind  up  with  less 
horizontal  banding. 

•  Densities  which  use  more  than  one  pass  should  only  be  used  for 
black-and-white  screen  dumps.  (Density  is  controlled  by  the  Den- 
sity setting  in  Preferences.  For  the  densities  supported  by  your 
printer,  see  the  list  of  printer  drivers  later  in  this  chapter.)  If  you 
use  a  multiple-pass  density  for  a  gray-scale  or  color-shade  dump, 
the  output  may  be  muddy  or  dark.  Multiple-pass  color  dumps  also 
dirty  the  printer  ribbon  (i.e.,  the  yellow  will  become  contaminated 
with  other  colors  on  the  ribbon.) 

For  faster  screen  dumps: 

•  The  lower  the  density  the  faster  the  print  out. 

•  Horizontal  dumps  are  much  faster  than  vertical  dumps. 

•  If  you  are  dumping  a  one  bitplane  image  (two  colors),  select  the 
black-and-white  mode  in  Preferences.  This  is  much  faster  than  a 
gray-scale  or  a  color  dump. 

•  Turning  on  the  Smoothing  option  doubles  the  printing  time.  Use 
the  Smoothing  option  for  the  final  copy  only. 
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Be  careful  which  dithering  mode  you  choose.  F-S  dithering  dou- 
bles the  printing  time,  while  Ordered  and  Half-tone  dithering 
cause  no  increase  in  printing  time. 

If  you  are  dumping  a  screen  that  in  low-resolution  mode  (320  x 
200  or  400  pixels)  displays  more  than  16  colors  (4  bitplanes)  or  in 
high-resolution  mode  (640  x  200  or  400  pixels)  displays  more 
than  4  colors  (2  bitplanes),  you  can  speed  up  the  dump  by 
moving  the  screen  to  the  back  of  the  display  ONCE  PRINTING 
HAS  STARTED.  This  is  easily  done  by  pressing  the  left  Amiga  key 
and  the  N  key  simultaneously. 


Supported  Printers 


Below  is  a  list  of  the  printer  drivers  available  for  use  with  the  Amiga 
computers.  Most  of  these  drivers  are  included  on  the  Extras  disk.  The  few 
drivers  that  are  not  on  Extras  are  available  from  the  printer  manufacturer 
or  from  the  Amiga  Developers  (amiga.dev)  Conference  on  BIX. 

You'll  notice  that  many  of  the  drivers  support  several  densities.  Density 
refers  to  the  number  of  dots  per  inch  that  are  used  to  make  the  print.  The 
higher  the  number  of  dots,  the  smaller  the  dots  will  be  and  the  clearer  the 
picture.  However,  the  higher  the  density,  the  slower  the  printing.  So,  in 
the  case  of  multiple  densities,  it  is  up  to  the  individual  user  to  decide 
whether  they  prefer  faster  printing  or  a  better  quality  print. 

When  applicable,  there  are  diagrams  of  standard  switch  settings  for  many 
of  the  printers. 

Alphacom AlphaPro 101 

•  Daisy-wheel  printer;  prints  text  only. 

•  Switch  setting: 

MODE  A:  ON  (bidirectional  print) 

MODE  B:  OFF  (no  line  feed  after  carriage  return) 

Tested  Interface  Card:  101  IPC  (IBM  PC) 

Brother HR-15XL 

•  Daisy-wheel  printer;  prints  text  only. 

•  Switch  settings: 


xxxxxxxx 

ON 
OFF 

xxxxxxxx 

12345678 
SW1 

12345678 
SW2 
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CalComp ColorMaster 

•  Thermal  transfer  b&w/color  printer;  prints  text  and  graphics. 

•  One  density  is  supported  —  203x200  dpi.  Select  a  density  of  1. 

•  This  is  a  dual  printer  driver.  Set  the  Paper  Size  setting  in  Prefer- 
ences to  Narrow  Tractor  for  use  with  the  ColorMaster  printer.  Set 
it  to  Wide  Tractor  for  use  with  the  ColorView-5912  printer  (for  a 
paper  size  of  11  x  17  inches). 

•  There  are  no  DIP  switches. 

CalComp ColorMaster2 

•  Thermal  transfer  b&w/color  printer;  prints  text  and  graphics. 

•  One  density  is  supported  —  203x200  dpi.  Select  a  density  of  1. 

•  This  is  a  dual  printer  driver.  Set  the  Paper  Size  setting  in  Prefer- 
ences to  Narrow  Tractor  for  use  with  the  ColorMaster  printer.  Set 

'*  it  to  Wide  Tractor  for  use  with  the  ColorView-5912  printer  (for  a 

paper  size  of  11  x  17  inches). 

•  This  driver  is  the  same  as  the  Calcomp ColorMaster  driver 

EXCEPT  that  this  one  is  approximately  2  times  faster  during  color 
dumps  and  requires  a  large  amount  of  memory  (up  to  1,272,003 
bytes  for  a  full  8  x  10  inch  [1600  x  2000  dot]  color  dump). 
Typically  full-size,  color  dumps  are  1600  x  1149  dots  and  require 
730,767  bytes. 

Memory  requirements  for  the  ColorView-5912  are  up  to 
2,572,803  bytes  for  a  full  10  x  16  inch  (2048  x  3200  dot)  color 
dump.  Typically  full-size  color  dumps  are  2048  x  2155  dots  and 
require  1,732,623  bytes. 

When  doing  a  non-color  printout,  memory  requirements  are 
one-third  of  what  is  needed  for  a  comparable  color  dump. 

•  There  are  no  DIP  switches. 

Canon PJ-1080A 

•  Ink  jet  b&w/color  printer;  prints  text  and  graphics. 

•  One  density  is  supported  —  83x84  dpi.  Select  a  density  of  1. 

•  Switch  settings: 

Canon  PJ-1080A 


X     X     X     X     X     X 


ON 
OFF 


12   3   4   5    6 
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CBM MPS1000  (Also  for  use  with  IBM  5152  Compatible  Printers) 

•  Dot  matrix  non-color  printer;  prints  text  and  graphics. 

•  Density     XDPI       YDPI        XYDPI     Comments 


1 

120 

72 

8640 

2 

120 

144 

17280 

Performs  two  passes 

3 

240 

72 

17280 

See  Note  2 

4 

120 

216 

25920 

Performs  three  passes; 
See  Note  2 

5 

240 

144 

34560 

Performs  two  passes; 
See  Note  2 

6 

240 

216 

51840 

Performs  three  passes; 
See  Note  2 

7 

Same 

as  a  Density  of  6 

•  Switch  settings: 
CBM  MPS1000 


X     X     X     X     X     X     X 


ON 
OFF 


12345678 


Dn  BJ-130  (with  Control  Capsule  48/XL  —  IBM  Proprinter 
patible) 

xxxxxxxxxx 

OFF 
ON 

xxxxxxxxxx 

123456789  10 
SW1 

123456789  10 
SW2 

NOTE:  If  you  own  a  Commodore  MPS1250  printer,  see  the  entry  for 
EpsonX.  They  are  compatible. 


>iablo 630 

•  Daisy-wheel  printer;  prints  text  only. 

•  Switch  settings: 

xxxxxxxx 

ON 
OFF 

xxxxxxxx 

12345678 
SW1 

12345678 
SW2 

Notes  are  on  page  4-18 
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Diablo Advantage D25 

•  Daisy-wheel  printer;  prints  text  only. 

•  Switch  settings: 

Parallel  Interface  is  recommended. 


OFF 

ON 

1 

X 

2 

X 

3 

X 

4 

X 

5 

X 

6 

X 

7 

X 

8 

X 

OFF 

ON 

1 

X 

2 

X 

3 

X 

4 

X 

5 

X 

6 

X 

7 

X 

8 

X 

LEFT 


RIGHT 


The  Left  switch  is  set  for  xON/xOFF  handshaking  and  no  line  feed 
after  carriage  return. 

Diablo C-150 

•  Ink  jet  b&w/color  printer;  prints  text  and  graphics. 

•  Line  feeds  are  always  equal  to  four  dots  (limitation  of  the  printer). 

•  One  density  is  supported  —  120x120  dpi.  Select  a  density  of  1. 

•  If  the  Paper  Size  setting  in  Preferences  is  Wide  Tractor,  a  maxi- 
mum print  width  of  8.5  inches  (for  wide  roll  paper)  will  be  used. 

•  Switch  settings: 


XXX 

XX                         XXX 

ON 
OFF 

12345678 
SW1 

EpsonQ  (24-pin  printer  compatible  with  the  Epson  *  'Q' '  series) 

•  Dot  matrix  b&w/color  printer;  prints  text  and  graphics. 

•  Drives  all  EpsonQ  (LQ1500,  LQ2500,  etc.)  compatible  printers. 


Density 

XDPI      YDPI       XYDPI 

Comments 

1 

90        180     16200 

2 

120        180    21600 

3 

180        180    32400 

4 

360        180    64800 

See  Note  2 

5 

Same  as  a  density  of  4 

6 

Same  as  a  density  of  4 

7 

Same  as  a  density  of  4 

Notes  are  on  page  4-18 
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•  If  the  Paper  Size  setting  in  Preferences  is  Wide  Tractor,  a  maxi- 
mum print  width  of  13.6  inches  (for  wide  carriage  printers)  will  be 
used. 

•  If  the  Paper  Type  setting  in  Preferences  is  Single,  only  16  of  the 
24  pins  are  used.  A  Paper  Type  of  Fanfold  uses  all  24  pins.  The 
Single  option  is  useful  for  those  printers  which  have  a  weak  power 
supply  and  cannot  drive  all  24  pins  continuously.  If  during  a  single 
pass  of  the  print  head  you  notice  that  the  top  two-thirds  of  the 
graphics  are  darker  than  the  bottom  one-third,  then  you'll  prob- 
ably need  to  drop  down  to  16  pins. 

EpsonX  (CBM MPS1250  and  8/9-pin  Epson  '  'X'  *  series  compatible) 

Dot  matrix  b&w/color  printer;  prints  text  and  graphics. 
Drives  all  EpsonX  (EX/FX/JX/LX/MX/RX,  etc.)  compatible  print- 
ers. 

If  the  Paper  Type  setting  in  Preferences  is  Single,  the  line  feed  will 
be  the  number  of  vertical  dots  printed,  minus  one-third  of  a  dot. 
(See  Note  1.) 


Density 

XDPI 

YDPI 

XYDPI 

Comments 

1 

120 

72 

8640 

2 

120 

144 

17280 

Performs  two  passes 

3 

240 

72 

17280 

See  Note  2 

4 

120 

216 

25920 

Performs  three  passes 

5 

240 

144 

34560 

Performs  two  passes;  See 
Note  2 

6 

240 

216 

51840 

Performs  three  passes; 
See  Note  2 

7  Same  as  a  density  of  6 

•  If  the  Paper  Size  setting  in  Preferences  is  Wide  Tractor,  a  maxi- 
mum print  width  of  13.6  inches  (for  wide  carriage  printers)  will  be 
used. 

•  Switch  settings: 
Commodore  MPS1250  Printer 


x        x 

x        x   x   x   x   x 


ON 
OFF 


x        x 

X  X    X     X     X    X 


12345678 
Serial/Parallel  Interface  Pack 


12345678 
Printer  Internal  Switch 


Notes  are  on  page  4-18 
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Epson  EX-1000  Printer 


XXX 
X  X  X  X  X 

ON 
OFF 

xxxxxxxx 

12345678 
SW2 

12345678 
SW2 

Epson  FX-80  Printer 


X  X 

X  X 

ON 
OFF 

X     XXX 
XXX     X 

12  3  4 

SWl 

12345678 
SW2 

EpsonXOld  (Older  8/9-pin  Epson  '  'X' '  printer  compatible) 

•  Use  this  driver  if  the  EpsonX  driver  doesn't  work  properly  in 
graphics  mode  on  your  EpsonX  compatible  printer. 

•  Dot  matrix  b&w  printer;  prints  text  and  graphics. 

•  Drives  all  very  old  EpsonX  (EX/FX/JX/LX/MX/RX,  etc.)  compati- 
ble printers  as  well  as  the  Star  Micronics  Gemini  10-X. 

•  Density     XDPI      YDPI        XYDPI     Comments 

1  60  72  4320 

2  120  72  8640 


Double  speed;  See  Note 
2 


3 
4 
5 


120 
240 
120 


72 
72 
72 


8640 

17280 

8640 


240 


240 


For  use  on  old  Star  print- 
ers 

72  1 7280     For  use  on  old  Star  print- 

ers; See  Note  2 

72  17280     Same  as  a  Density  of  4; 

See  Note  2 

•  If  the  Paper  Size  setting  in  Preferences  is  Wide  Tractor,  a  maxi- 
mum print  width  of  13.6  inches  (for  wide  carriage  printers)  will  be 
used. 

•  Switch  settings  for  Star  Micronics  Gemini  10-X  printer: 


xxxxxxxx 


1234   5   678 
SWl  (internal) 


ON 
OFF 


x   x 


X     X 


12    3   4 
SW2  (external] 


Notes  are  on  page  4-18 
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Generic 

•  Text  only  printer;  makes  few  assumptions  about  the  printer's 

capabilities. 

Howtek Pixelmaster 

•  Plastic  ink  jet  b&w/color  printer;  prints  text  and  graphics. 

•  Density 

XDPI      YDPI        XYDPI 

1 

80          80           6400 

2 

120         120         14400 

3 

160         160         25600 

4 

240         240         57600 

5 

Same  as  a  density  of  4 

6 

Same  as  a  density  of  4 

7 

Same  as  a  density  of  4 

•  Maximum  print  area  is  8.0  x  10.0  inches. 

•  There  are  no  DIP  switches. 

HP DeskJet 

•  Ink  jet  b&w  printer;  prints  text  and  graphics. 

•  Density 

XDPI      YDPI        XYDPI 

1 

75          75           5625 

2 

100         100         10000 

3 

150         150         22500 

4 

300        300         90000 

5 

Same  as  a  density  of  4 

6 

Same  as  a  density  of  4 

7 

Same  as  a  density  of  4 

•  Maximum  print  area  is  8.0  x  10.0  inches. 

•  Switch  settings: 

xxxxxxxx 


ON 
OFF 


xxxxxxxx 


12  3  4  5  6  7   8 
SW1 


12  3  4  5  6  7  8 
SW2 


HP LaserJet  (LaserJet  Plus/LaserJet  II  compatible) 

•  Laser  engine  b&w  printer;  prints  text  and  graphics. 

•  Density     XDPI      YDPI       XYDPI 

1  75  75  5625 

2  100        100         10000 

3  150        150        22500 

4  300        300        90000 

5  Same  as  a  density  of  4 

6  Same  as  a  density  of  4 

7  Same  as  a  density  of  4 

•  Maximum  print  area  is  8.0  x  10.0  inches. 

•  There  are  no  DIP  switches. 
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HP PaintJet 

•  Ink  jet  b&w/color  printer;  prints  text  and  graphics. 

•  One  density  is  supported  —  180x180  dpi.  Select  a  density  of  1. 

•  Switch  settings: 


x   x   x   x   x   x   x 


ON 
OFF 


12    3   4   5    6   7 


HP_ThinkJet 


•  Ink  jet  b&w  printer;  prints  text  and  graphics. 

•  Density     XDPI       YDPI        XYDPI 

1  96         96  9216 

2  192  96  18432 

3  Same  as  a  density  of  2 

4  Same  as  a  density  of  2 

5  Same  as  a  density  of  2 

6  Same  as  a  density  of  2 

7  Same  as  a  density  of  2 

•  Switch  settings: 


x  x 

x         xxx        xx 


ON 
OFF 


12345678 


Imagewriter  II  (Imagewriter  compatible) 

•  Dot  matrix  b&w/color  printer;  prints  text  and  graphics. 

Comments 


Performs  two  passes 
Performs  two  passes 
Performs  two  passes 


•  Density     XDPI 

YDPI 

XYDPI 

1            80 

72 

5760 

2          120 

72 

8640 

3          144 

72 

10368 

4          160 

72 

11520 

5          120 

144 

17280 

6          144 

144 

20736 

7          160 

144 

23040 

•  Switch  settings: 

Imagewriter: 

X     X     X     X 

X     X 

ON 

X 

X 

OFF 

12    3   4   5 

6   7  8 

SW1 

xxx 


12   3   4 
SW2 
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Imagewriter  II: 

ON 
OFF 

X     X    X     X     X           XX 
X 

X     X 
XX                  XX 

12345678 
SW1 

12   3   4   5    6 
SW2 

Nee Pinwriter  (24-wire  Pinwriter  compatible  (P5/P6/P7/P9/P2200)) 

•  Dot  matrix  b&w/color  printer;  prints  text  and  graphics. 

•  Drives  all  Nee  24-wire  Pinwriter  compatible  printers. 

•  Density     XDPI       YDPI        XYDPI     Comments 


1 

90 

180 

16200 

2 

120 

180 

21600 

3 

180 

180 

32400 

4 

120 

360 

43200 

Performs  two  passes 

5 

180 

360 

64800 

Performs  two  passes 

6 

360 

180 

64800 

7 

360 

360 

129600 

Performs  two  passes 

•  If  the  Paper  Size  setting  in  Preferences  is  Wide  Tractor,  a  maxi- 
mum print  width  of  13.6  inches  (for  wide  carriage  printers)  will  be 
used. 

•  Switch  settings  for  NEC  Pinwriter  P9XL: 


X 

X 

X 

X    X 

X 

X 

X 

ON 
OFF 

1 

2 

3 

4   5 
SW1 

6 

7 

8 

X 

X 

X 

X 
X 

X 

X 

X 

ON 
OFF 

1 

2 

3 

4   5 

SW2 

6 

7 

8 

X 

X 

X 

X    X 

X 

X 

X 

ON 
OFF 

12345678 
SW3 
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Okidata 92 


•  Dot  matrix  non-color  printer;  prints  text  and  graphics. 

•  Line  feeds  are  always  7/72  of  an  inch  (limitation  of  printer  in 


graphics  mode). 
•  One  density  is  supported  - 

Okidata 2931 


-  72x72  dpi.  Select  a  density  of  1. 


•  Dot  matrix  b&w/color  printer;  prints  text  and  graphics. 

•  Drives  292  or  293  using  the  IBM  interface  module. 

•  If  the  Paper  Type  setting  in  Preferences  is  set  to  Single,  line  feeds 
are  equal  to  the  number  of  vertical  dots  printed  less  one-half  of  a 
dot  (See  Note  3.) 

XYDPI 
17280 
34560 
34560 
69120 


Density 
1 
2 
3 
4 
5 
6 
7 


XDPI 
120 
240 
120 
240 


Comments 


Performs  two  passes 
Performs  two  passes 


YDPI 
144 
144 
288 
288 
Same  as  a  density  of  4 
Same  as  a  density  of  4 
Same  as  a  density  of  4 
If  the  Paper  Size  setting  in  Preferences  is  Wide  Tractor,  a  maxi- 
mum print  width  of  13.6  inches  (for  wide  carriage  printers)  will  be 
used. 
Switch  settings: 

Interface:    ML-292/293  Personality  Module 


SP1 

*    * 

A 

Set  the  jumper 

SP4    B    * 

*    * 

Set  the  jumper  in  the  position  closest  to  A 

*    A 

B  1  *    *  1     * 

Set  the  jumper  in  the  position  closest  to  B 

Notes  are  on  page  4-18 
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Okimate-20 

•  Thermal  transfer  b&w/color  printer;  prints  text  and  graphics. 

•  Line  feeds  are  equal  to  an  even  number  of  dots  printed,  (i.e.,  if 
three  dots  were  printed,  four  dots  will  be  advanced). 

•  One  density  is  supported  —  120x144  dpi.  Select  a  density  of  1. 

•  Switch  settings: 
Parallel  Plug'n  Print  Kit 


x   x   x   x 


ON 
OFF 


12    3   4   5   6 


NOTE:  Switch  5  on  some  models  controls  the  white  space  be- 
tween the  lines  of  a  graphic  dump. 

Serial  Plug'n  Print  Kit 


XX                        X 

XXX 

ON 
OFF 

X 
X     X     X    X            X 

12   3   4   5   6 
SW1 

12   3   4   5   6 
SW2 

NOTE:  The  SW1  settings  specify  a  baud  rate  of  9600,  xON/xOFF 
handshaking,  8  bits,  and  no  parity.  On  some  models,  Switch  5  of 
SW2  controls  the  white  space  between  the  lines  of  a  graphic 
dump. 

Quadram QuadJet 

•  Ink  jet  b&w/color  printer;  prints  text  and  graphics. 

•  One  density  is  supported  —  83x84  dpi.  Select  a  density  of  1. 

•  There  are  no  DIP  switches. 

Qume LetterPro 20 

•  Daisy-wheel  printer;  prints  text  only. 

•  Switch  settings: 


X 

X     X     X     X     X     X            X 

ON 
OFF 

X     X 

X                  XX 

12345678 
SWA 

12   3   4   5 
SWB 
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Seiko 5300 

THIS  DRIVER  IS  NOT  ON  THE  WORKBENCH  OR  EXTRAS 
DISK.  IT  IS  AVAILABLE  FROM  SEIKO  OR  IN  THE  AMIGA.DEV 
CONFERENCE  ON  BIX. 

•  Thermal  transfer  b&w/color  printer;  prints  graphics  only. 

•  Density  XDPI  YDPI      XYDPI     Comments 

1  152      152       23104     Drives  CH-5301  printer 

2  203     203       41209     Drives  CH-5312  printer 

3  240     240       57600     Drives  CH-5303  printer 

4  Same  as  a  Density  of  3 

5  Same  as  a  Density  of  3 

6  Same  as  a  Density  of  3 

7  Same  as  a  Density  of  3 

•  There  are  no  DIP  switches. 

Seiko 5300a 

THIS  DRIVER  IS  NOT  ON  THE  WORKBENCH  OR  EXTRAS 
DISK.  IT  IS  AVAILABLE  FROM  SEIKO  OR  IN  THE  AMIGA.DEV 
CONFERENCE  ON  BIX. 

•  Thermal  transfer  b&w/color  printer;  prints  graphics  only. 

•  Density  XDPI  YDPI      XYDPI     Comments 

1  152      152       23104     Drives  CH-5301  printer 

2  203     203       41209     Drives  CH-5312  printer 

3  240     240       57600     Drives  CH-5303  printer 

4  Same  as  a  Density  of  3 

5  Same  as  a  Density  of  3 

6  Same  as  a  Density  of  3 

7  Same  as  a  Density  of  3 

•  This  driver  is  the  same  as  the  Seiko 5300  driver  EXCEPT 

that  it  is  approximately  two  times  faster  during  color  dumps 
and  it  requires  a  large  amount  of  memory  (up  to  1,564,569 
bytes  for  a  full  8  x  10  inch  [1927  x  2173  dot]  color  dump). 
Typically  full-size,  color  dumps  are  1927  x  1248  dots  and 
require  898,569  bytes  of  memory.  When  doing  a  non-color 
printout,  the  memory  requirements  are  one-third  of  what  is 
needed  for  a  comparable  color  dump. 

•  There  are  no  DIP  switches. 
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Tektronix 4693D 

THIS  DRIVER  IS  NOT  ON  THE  WORKBENCH  OR  EXTRAS 
DISK.  IT  IS  AVAILABLE  FROM  TEKTRONIX  OR  IN  THE  AMIGA- 
.DEV  CONFERENCE  ON  BIX . 

•  Thermal  transfer  b&w/color  printer;  prints  graphics  only. 

•  One  density  is  supported — 300x300  dpi.  Select  a  density  of  1 . 

•  Due  to  the  way  the  printer  images  a  picture,  none  of  the 
printer  Preferences  options  affect  the  printout  with  the  follow- 
ing exceptions: 

a)Aspect  —  Horizontal,  Vertical 
b)Shade  —  B&W,  Grey-Scale,  Color 
As  a  result  of  this  only  full-size  pictures  can  be  printed. 

•  The  following  keypad  menu  options  may  be  set  from  the 
printer's  keypad.  For  normal  prints  set  the  option  to  the 
setting  specified  below: 

3b — Color  Adjustment — set  to  "do  not  adjust" 
3d — Video  Color  Correction — set  to  "do  not  adjust" 
5 — Background  Color  Exchange — set  to  "print  colors  as  re- 
ceived" 

•  Once  a  picture  has  been  printed,  additional  copies  may  be 
printed  without  resending  by  using  the  printer's  keypad. 

Tektronix 4696 

THIS  DRIVER  IS  NOT  ON  THE  WORKBENCH  OR  EXTRAS 
DISK.  IT  IS  AVAILABLE  FROM  TEKTRONIX  OR  IN  THE  AMIGA- 
.DEV  CONFERENCE  ON  BIX. 

•  Ink  jet  b&w/color  printer;  prints  text  and  graphics. 

•  Line  feeds  are  always  four  dots  (limitation  of  the  printer). 

•  It  supports  three  densities: 

121  x  120  dpi    Select  a  Density  of  1;  outputs  all  colors  in 

one  pass 
242  x  120  dpi    B&W;  Select  a  density  of  2;  performs  a  dou- 
ble-pass on  black 
242  x  120  dpi    Color;  Select  a  density  of  3;  performs  a  dou- 
ble pass  on  all  colors 
Selecting  a  density  of  2  or  higher  doesn't  give  you  true  242 
dpi  resolution,  since  the  printer  only  supports  121  x  dots  per 
inch.  Instead,  selecting  a  density  of  2  or  higher  tells  the 
printer  to  go  into  its  double  pass  mode.  In  this  mode,  it 
outputs  a  line  of  dots  at  121  dpi,  then  it  outputs  the  line  again 
— shifted  to  the  right  by  1/242  of  an  inch.  This  produces 
much  more  vibrant  colors  and  gives  the  illusion  of  a  higher 
resolution.  One  drawback  to  this  method,  however,  is  that 
large  areas  of  solid  colors  (red,  green,  and  blue,  specifically) 
tend  to  oversaturate  the  paper  with  ink. 
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The  densities  1  through  3  correspond  to  the  printer's  graphics 
printing  modes  1  through  3,  respectively. 

•  If  the  Paper  Size  setting  in  Preferences  is  Wide  Tractor,  a  maxi- 
mum print  width  of  9.0  inches  (for  wide  carriage  printers)  will  be 
used. 

•  Switch  settings: 


OFF 

ON 

1 

X 

2 

X 

3 

X 

4 

X 

Toshiba P351C  (24-pin  Toshiba  compatible) 

•  Dot  matrix  b&w/color  printer;  prints  text  and  graphics. 

•  Drives  all  Toshiba P351C  compatible  printers. 

•  Density     XDPI       YDPI        XYDPI 

1  180         180         32400 

2  360         180         64800 

3  Same  as  a  density  of  2 

4  Same  as  a  density  of  2 

5  Same  as  a  density  of  2 

6  Same  as  a  density  of  2 

7  Same  as  a  density  of  2 

•  If  the  Paper  Size  setting  in  Preferences  is  Wide  Tractor,  a  maxi- 
mum print  width  of  13.5  inches  (for  wide  carriage  printers)  will  be 
used. 

•  Switch  settings: 


X 
X     X 

X           XX 

x             x 

8   7   6 

5   4   3    2    1 
PI 

XXX 

x   x   x   x   x 

87654321 
P3 


ON 
OFF 


ON 
OFF 


X 

x 

X 

X 

X 

X 

X 

X 

8 

7 

6 

5 

4 

3 

2 

1 

P2 

x 

X 

X 

X 

X 

X 

X 

X 

87654321 
P4 
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Toshiba P351SX  (24-pin  Toshiba  compatible) 

•  Dot  matrix  b&w/color  printer;  prints  text  and  graphics. 

•  Drives  all  Toshiba P351SX  (321SL,  321SLC,  341SL)  compati- 
ble printers. 

XYDPI 

32400 

64800 

64800 
129600 


Density 
1 
2 
3 
4 
5 
6 
7 


XDPI 
180 
360 
180 
360 


Comments 


Performs  two  passes 
Performs  two  passes 


YDPI 
180 
180 
360 
360 
Same  as  a  density  of  4 
Same  as  a  density  of  4 
Same  as  a  density  of  4 
If  the  Paper  Size  setting  in  Preferences  is  Wide  Tractor,  a  maxi- 
mum print  width  of  13.5  inches  (for  wide  carriage  printers)  will  be 
used. 

Switch  settings: 

If  using  the  serial  interface,  set  the  jumpers  in  the  following  posi- 
tions: 1  &  2;  7  &  10;  8  &  9;  11  &  12;  13  &  14.  See  the  diagram 
below: 


0 

3 
4 
5 
6 


16 
15 
14 
12 
12 
11 


Z1Q 


s_a 


Xerox 4020 


Ink  jet  b&w/color  printer;  prints  text  and  graphics. 

Line  feeds  are  always  equal  to  4  dots  (limitation  of  the  printer). 

This  driver  is  IDENTICAL  to  the  Diablo C-150  driver  EXCEPT 

that  it  outputs  all  black  dots  TWICE.  This  is  a  special  feature  of  this 
printer  and  produces  much  more  solid,  dark  black  shades.  Please 
note  that  some  printing  time  overhead  results  from  this  feature;  if 

you  don't  want  it,  use  the  Diablo C-150  driver. 

Two  densities  are  supported: 
121x120  dpi       Select  a  density  of  1 
242x240  dpi        Select  a  density  of  2 
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Selecting  a  density  of  2  or  higher  really  doesn't  give  you  true 

240  dpi  resolution  since  the  Xerox 4020  only  has  121  x  dots 

per  inch.  Instead  this  mode  tells  the  printer  to  go  into  it's  pseudo 
240  dpi  mode.  Here,  it  outputs  a  line  of  dots  at  121  dpi;  moves 
the  paper  up  1/240  of  an  inch  and  outputs  the  line  again  (shifted 
to  the  right  by  1/240  of  an  inch).  This  produces  much  more 
vibrant  colors  and  gives  the  illusion  of  more  resolution.  One 
drawback  is  that  large  areas  of  solid  colors  (red,  green,  and  blue 
specifically)  tend  to  oversaturate  the  paper  with  ink. 
If  the  Paper  Size  setting  in  Preferences  is  Wide  Tractor,  a  maxi- 
mum print  width  of  9.0  inches  (for  wide  roll  paper)  will  be  used. 
Switch  settings: 


OFF 

ON 

1 

X 

2 

X 

3 

X 

4 

X 

LEFT 


OFF 

ON 

1 

x 

2 

X 

3 

X 

4 

X 

5 

X 

6 

X 

7 

X 

RIGHT 


NOTES: 


1.  This  is  only  true  when  72  YDPI  is  selected.  This  option  is  useful  if  you 
notice  tiny  white,  horizontal  stripes  in  your  printout. 

2.  In  this  mode  the  printer  cannot  print  two  consecutive  dots  in  a  row.  It 
is  recommended  that  you  only  use  this  density  for  black-and-white, 
shade  dumps. 

3.  This  is  only  true  when  144  YDPI  is  selected.  This  option  is  useful  if  you 
notice  tiny  white,  horizontal  stripes  in  your  printout. 
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5.  CHANGING  YOUR  STARTUP  SEQUENCES 

When  you  boot  your  Amiga  computer  with  the  Workbench  disk,  Amiga- 
DOS  executes  the  file  called  Startup-Sequence  in  the  Workbench's  S: 
directory: 

1  Addbuffers  dfO:  10 

2  c:SetPatch  >NIL:  .patch  system  functions 

3  cdc: 

4  echo  '  'A500/A2000  Workbench  disk.  Release  1.3  version  34. 19*N" 

5  SysiSystem/FastMemFirst ;  move  C00000  memory  to  last  in  list 

6  BindDrivers 

7  SetClock  load  ;load  system  time  from  real  time  clock  (A1000  owners  should 

8  ;replace  the  SetClock  load  with  Date) 

9  FF  >NIL:  -0  ;speed  up  Text 

10  resident  CLI  L:Shell-Seg  SYSTEM  pure  add;  activate  Shell 

11  resident  c:  Execute  pure 

12  mount  newcon: 

13  ; 

14  failat  11 

15  run  execute  s:StartupII  ;This  lets  resident  be  used  for  rest  of  script 

16  wait  >NIL:  5  mins  ;wait  for  StartupII  to  complete  (will  signal  when  done) 

17  ; 

18  SYS:System/SetMap  usal  ;Activate  the  ()/*  on  keypad 

19  path  ram:  c:  sys: utilities  sys:system  s:  sys:prefs  add  ;set  path  for  Workbench 

20  LoadWB  delay 

21  endcli>NIL: 

Workbench's  Startup-Sequence  file 
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To  make  the  most  of  the  speed  of  resident  commands,  most  of  the  1.3 
Startup-Sequence  has  been  moved  to  a  second  file  named  StartupII.  This 
file  is  run  by  the  initial  startup-sequence  after  the  Shell-Seg  is  made 
resident: 

1  resident  c:  Resident  pure 

2  resident  c:List  pure  ;pre-load  LIST  and  CD 

3  resident  c:CD  pure 

4  resident  c:  Mount  pure  ;the  next  3  are  loaded  for  speed  during  startup 

5  resident  cAssign  pure 

6  resident  c:  Makedir  pure 

7  ;make  IF,  ENDIF,  ELSE,  SKIP,  ENDSKIP,  and  ECHO  resident  if 

8  ;you  use  scripts  much,  and  can  afford  the  ram. 

9  ;also  make  Failat,  WAIT,  and  ENDCLI  resident  if  you  use  IconX  a  lot 

10  makedirram:t 

11  assign  T:  ram:t  ;set  up  T:  directory  for  scripts 

12  makedir  ram:env ;  set  up  ENV:  directory 

13  assign  ENV:  ram:env 

14  makedir  ramrclipboards  ;set  up  CLIPS:  assign 

15  assign  CLIPS:  ram: clipboards 

16  mount  speak:  ;just  mounting  doesn't  take  much  ram  at  all 

17  mount  aux: 

18  mount  pipe: 

19  resident  Mount  remove  ;if  you  have  enough  ram,  keep  these  resident 

20  resident  Assign  remove  ; by  removing  these  lines 

21  resident  Makedir  remove 

22  ; 

23  break  1  C  ;signal  to  other  process  its  ok  to  finish 

Workbench's  StartupII  file 

In  addition,  there  are  new  s:CLI-Startup  and  s: Shell-Startup  files  which 
are  the  respective  startup  files  executed  by  each  NEWCLI  or  NEW- 
SHELL  (unless  an  alternate  '  'FROM' '  script  is  provided  in  the  NEWCLI 
or  NEWSHELL  command  line). 

All  of  these  S:  directory  startup  files  may  be  edited  with  any  text  editor, 
such  as  ED  or  MEMACS,  to  create  your  own  customized  startup  se- 
quence. This  allows  you  to  set  up  a  preferred  working  environment  or  to 
take  advantage  of  additional  hardware  or  RAM.  Sample  customization 
of  the  startup  files  include: 

Startup-Sequence 

Opening  an  initial  SHELL 

Setting  up  additional  paths  and  logical  names 

Mounting  hard  disk  partitions 

Setting  up  a  RAD:  (Recoverable  ramdrive. device) 

Transferring  control  to  a  RAD:,  Workbench,  or  a  hard  drive 

StartupII 

Relabeling  RAM:  for  programs  that  can't  handle  spaces  in  a  volume 

name  (default  volume  name  is  *  'RAM  DISK' ') 

Making  more  commands  resident 

Setting  environment  variables  such  as  ENV:Editor  (used  by  MORE) 

Shell-Startup 

Setting  up  personal  command  aliases 

5-2  Changing  Your  Startup  Sequences 


This  chapter  takes  you  through  several  examples  of  modifying  these 
startup  sequence  files,  including  instructions  on  rebooting  from  the  Re- 
coverable ramdrive.  device.  Before  attempting  to  alter  any  of  the  startup 
scripts,  you  should  make  a  backup  copy  of  your  Workbench  disk.  Also, 
remember  that  the  system  generally  looks  for  scripts  in  the  S:  directory.  If 
you  assign  S:  to  a  different  device  (such  as  a  hard  disk  or  ramdrive) 
during  or  after  your  startup,  you  must  also  place  your  modified  scripts  in 
that  S:  directory.  We  suggest  that  you  keep  backup  copies  of  all  of  your 
modified  startup  and  MountList  files  on  a  floppy  disk. 

The  following  examples  describe  some  simple  changes  that  can  be  made 
to  startup  scripts. 


Opening  an  Initial  Shell 

Add  the  following  lines  to  the  end  of  the  Startup-Sequence,  before  line 
22"endcli  >NIL:". 

cd  SYS:    ;   You  may  prefer  cd  RAM: 
NewShell  newcon : 0/0/640/200/AmigaShell 

Setting  up  Additional  Paths  and  Logical  Names 

Paths  and  logical  assignments  to  other  floppy  disks  can  be  added  in  the 
Startup-Sequence  or  StartupH  file.  For  instance,  if  you  always  boot  with 
the  Extras  disk  in  dfl:,  you  may  want  to  add  a  path  there: 

path  "Extras  1.3:"  add 

If  you  always  boot  with  a  C  source,  Includes,  and  Lib  disk  in  dfl:  (here 
called  MySrc),  you  might  find  it  convenient  to  set  logical  names  for  the 
directories.  If  your  other  scripts  always  reference  these  logical  names,  you 
will  only  have  to  change  these  logical  assignments  when  your  system  or 
configuration  changes. 


assign  SRC:   MySrc: 

assign  INCLUDE:   MySrc: include 

assign  LIB:   MySrc: Lib 


Mounting  Hard  Disk  Partitions 

After  BindDrivers  in  the  Startup-Sequence,  you  may  wish  to  mount 
additional  hard  disk  partitions,  assign  all  system  directories  to  hard  disk 
directories,  and  add  paths  to  personal  directories  on  your  hard  disk 
partitions.  One  flexible  method  of  accomplishing  this  is  to  put  all  of  these 
additional  commands  in  a  script  called  hd-startup  in  the  S:  directory  of 
your  first  partition,  then  add  a  line  to  Execute  dhO:s/hd-startup  after  the 
BindDrivers  line  in  the  Startup-Sequence. 

Before  executing  the  hd-startup  file,  CD  to  RAM:  in  case  EXECUTE 
needs  to  make  a  temporary  file.  If  you  use  your  boot  disk  on  more  than 
one  Amiga,  these  lines  (added  after  BindDrivers)  will  only  execute  hd- 
startup  when  you  boot  on  your  hard  drive  system.  (Depending  on  your 
configuration,  you  may  have  to  change  dhO:  to  a  different  unit  name.) 
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cd  ram: 

failat  30 

assign  >NIL:  dhO:  exists 

if  not  warn 

execute  dhO : s/hd-startup 
endif 
failat  10 

Relabeling  RAM: 

Edit  the  StartupII  file,  and  add  the  following  line  after  "Assign  CLIPS : 
ram:  clipboards"  (line  15): 

relabel  drive  RAM:  name  RAMDISK 


Making  Additional  Commands  Resident 

Most  of  the  C:  directory  commands  and  the  1.3  MORE  program  can  be 
made  resident  (as  shown  by  the  '  'p' '  or  pure  bit  displayed  when  you 
LIST  these  commands).  Resident  commands  are  extremely  fast,  reduce 
memory  usage  when  multitasking,  and  generally  make  SHELL  work 
more  pleasant,  especially  on  a  floppy-based  system. 

One  suggested  method  for  making  more  commands  resident  is  to  create 
a  separate  script  called  *  'rescom' '  similar  to  the  following  example: 

resident  c:dir  pure 

resident  c:copy  pure 

resident  c: delete  pure 

resident  c:ed  pure 

resident  sys: Utilities/More  pure 

Place  the  script  in  your  S:  directory,  then  edit  s:StartupII  adding  this  line 
near  the  end: 

run  >NIL:    execute  s: RESCOM 

Because  there  is  one  resident  list  for  the  whole  system,  you  can  RUN  the 
EXECUTE  of  your  rescom  script,  allowing  your  StartupII  to  complete 
while  the  commands  are  being  made  resident. 

Setting  Environment  Variables 

The  1.3  MORE  program,  when  started  from  the  CLI  or  SHELL,  now 
allows  you  to  edit  the  file  you  are  looking  at,  using  any  editor  that  can  be 
passed  a  filename  as  a  single  command  line  argument.  MORE  gets  the 
name  of  your  preferred  editor  from  the  environment  variable  EDITOR.  If 
you  wish  to  use  this  feature  of  MORE,  you  should  add  a  line  to  StartupII 
to  SETENV  the  EDITOR  environment  variable  to  the  path  and  name  of 
the  text  editor  you  use.  Add  the  SETENV  line  after  the  StartupII  line  that 
assigns  ENV:  to  RAM:ENV  (line  13). 

SETENV  EDITOR  C :  ed 
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Adding  Personal  Command  Aliases  to  s:Shell-Startup 

Using  a  text  editor,  add  alias  commands  to  the  Shell-Startup. 

Examples:    alias  ns  newshell 
alias  es  endshell 
alias  ex  execute 
alias  Is  list 
alias  prefs  sys:prefs/Preferences 

Mounting  a  Recoverable  Ramdrive 

The  MountList  file  in  the  DEVS:  directory  of  Workbench  1.3  contains  an 
entry  for  RAD:,  a  recoverable  ramdrive  which  can  be  rebooted  from 
when  using  Version  1.3  Kickstart.  The  size  of  RAD:  may  be  modified  by 
editing  the  HighCyl  value  of  the  RAD:  entry  in  the  DEVS:MountList  file. 
Note  that  when  you  change  the  size  (HighCyl)  of  RAD:  in  the  MountList, 
you  must  perform  a  cold  powerup  before  attempting  to  mount  RAD:  at 
the  new  size. 

On  a  1  MB  Amiga  with  no  hard  drive,  a  small  RAD:  can  be  used  to  hold 
your  S:  directory  and  some  common  C:  directory  commands.  If  you  have 
more  than  2  MB  of  RAM,  you  may  want  to  try  a  floppy-sized  880K  RAD: 
(HighCyl  =  79).  The  Workbench  disk  can  be  diskcopied  to  an  880K 
ramdrive  for  a  super-fast,  recoverable  Workbench-in-RAM  which  can  be 
rebooted  from  with  1.3  Kickstart.  Hard  drive  owners  might  wish  to  set  up 
a  RAD:  that  just  contains  the  minimum  number  of  files  and  directories 
required  to  transfer  control  to  a  hard  drive. 

Ramdrive  Workbench — For  Amigas  with  more  than  2  MB  of  RAM 

A  ramdrive  Workbench  is  extremely  useful  if  you  have  a  Megabyte  of 
RAM  to  spare  and  no  hard  drive.  On  a  cold  powerup,  these  changes  will 
mount  an  880K  RAD:  and  DISKCOPY  your  boot  disk  to  it.  This  takes 
about  one-fourth  the  time  of  a  floppy-to-floppy  DISKCOPY  and  is  not 
repeated  when  you  reboot.  All  system  directories  are  assigned  to  RAD:  so 
that  the  rest  of  the  Startup-Sequence  and  StartupII  are  executed  very 
quickly  and  dfO:  is  left  totally  free  for  use  as  a  work  drive. 

In  conjunction  with  Version  1.3  Kickstart,  you  can  reboot  from  the 
resulting  RAD:.  After  making  the  following  changes,  turn  your  Amiga  off 
for  at  least  30  seconds.  Turn  it  back  on,  and  boot  with  your  modified 
Workbench.  Note  that  when  the  DISKCOPY  of  dfO:  to  RAD:  is  complete, 
a  requester  will  flash  twice.  This  is  normal. 

1.  Edit  the  devs/MountList  file  and  change  the  HighCyl  value  of  RAD:  to 
HighCyl  =  79  (same  HighCyl  as  an  880K  floppy). 

2.  Insert  the  following  lines  in  your  Startup-Sequence,  between  the 
FastMemFirst  and  BindDrivers  lines. 

failat  30 

assign  >NIL:  RAD:  exists 

if  warn 

echo  "Mounting  RAD:" 

mount  RAD: 
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if  not  exists  RADx 
echo  "Backing  up  dfO:  to  RAD:" 

SYS:System/diskcopy  <NIL:  dfO:  to  RAD:  name  "RAMWB" 
endif 
endif 
RAD:c/failat  10 

RAD:c/cd  RADx 

RAD:c/echo  'Transferring  control  to  RAD:...  "  NOLINE 

assign  c:  RADx 

assign  s:  RAD:s 

assign  1:  RAD:1 

assign  libs:  RAD:libs 

assign  devs:  RAD:devs 

assign  fonts:  RAD:  fonts 

assign  sys:  RAD: 

echo  "Done" 

Minimal  Ramdrive  for  Transferring  Control  to  an  A2090  Hard 
Disk  Controller  and  Hard  Drive 

A  small  rebootable  ramdrive  can  be  used  to  transfer  control  to  a  hard 
drive.  This  allows  users  with  non-autoboot  hard  disk  controllers  (A2090s) 
to  reboot  without  placing  a  Workbench  in  dfO:  The  ramdrive  must 
contain  your  devs/system-configuration  file,  s:  startup-sequence  file,  and 
any  necessary  files  and  directories  to  get  through  BindDrivers  and  the 
assignment  of  control  to  a  hard  drive  partition  containing  Workbench. 

This  startup  requires  an  initial  partition  containing,  at  minimum,  the  files 
and  directories  required  for  executing  the  hd-startup.  The  hd-startup  will 
mount  your  additional  partitions  and  assign  system  logical  directories  to 
the  partition(s)  containing  the  Workbench  directories.  Also  listed  are 
some  additional  files  and  directories  you  will  need  in  this  initial  partition  if 
you  get  an  A2090A  autoboot  controller  (you  may  want  to  put  them  there 
now  or  at  least  leave  room  for  them).  Note  that  these  files  are  just  enough 
to  transfer  control  to  another  (probably  FFS)  partition  containing  all  of  the 
Workbench  directories  and  commands.  If  you  plan  to  run  off  the  initial 
partition,  you  might  as  well  copy  all  of  Workbench  there. 

1.  Make  sure  your  initial  hard  disk  partition  contains  the  following  direc- 
tories and  commands: 
s  (dir) 

startup-sequence  (autoboot) 

hd-startup 
c  (dir) 

cd 

assign 

echo 

mount 

BindDrivers  (autoboot) 

AddBuffers  (autoboot) 
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SetPatch  (autoboot) 

devs  (dir) 

MountList 

system-configuration  (autoboot) 

libs  (dir) 

icon.library  (autoboot) 

1  (dir) 

disk-validator 

FastFileSystem  (if  mounting  FFS  partitions) 

System  (dir) 

FastMemFirst  (autoboot) 

Expansion  (dir) 

other  non-autoboot  drivers  (autoboot) 

2.  Copy  your  A2090  hard  disk  driver  and  icon  (HdDisk  and  HdDisk. 
info)  to  two  places:  the  Expansion  drawer  of  your  Workbench  disk, 
and  the  Expansion  drawer  of  the  hard  disk  partition  which  will  be  your 
SYS:  (the  one  containing  all  of  the  Workbench  directories).  In  the 
following  examples,  that  partition  is  FFO:  which  is  assigned  the  name 
FASTWB: 

3.  Edit  the  devs/MountList  file  for  RAD:,  changing  the  HighCyl  value 
from  21  to  7.  Add  MountList  entries  for  any  additional  partitions  you 
have. 

4.  Add  the  following  lines  to  the  Startup-Sequence  immediately  after  the 
Binddrivers  line  (line  6).  You  may  have  to  change  the  reference  to 
dhO:  to  a  different  initial  partition  unit,  depending  on  your 
configuration. 

failat  30 

assign  >NIL:  INIT:  dhO: 

if  not  warn 

cd  INIT: 

execute  INIT:s/hd-startup 
endif 
failat  10 

;  Now  you  should  be  running  off  your  hard  drive  Workbench 
;  Create  the  RAD:  for  rebooting 
assign  >NIL:  RAD:  exists 
if  warn 
echo  "Mounting  RAD:..."  NOLINE 
mount  RAD: 
if  not  exists  RAD:c 
echo  ' 'setting  up..."  NOLINE 
relabel  drive  RAD:  name  RamDrive 
makedir  RADx 

copy  c:AddBuffers|assign|BindDrivers|cd|copy|echo  RADx  quiet 
radx/copy  c:  endif |execute|failat|if|makedir|SetPatch  RADx  quiet 
radx/makedir  RAD:  devs 

radx/copy  devs:  system-configuration  RAD:  devs  quiet 
radx/makedir  RAD:L 
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radx/copy  L:  disk-validator  RAD:L  quiet 

rad:c/makedir  RAD:Libs 

radx/copy  Libs: icon. library  RAD:Libs  quiet 

radx/makedir  RAD:  System 

radx/copy  SYS:System/FastMemFirst  RAD:System  quiet 

radx/makedir  RAD:s 

radx/copy  s: startup-sequence  RAD:s  quiet 

radx/makedir  rad:  Expansion 

radx/copy  sys:  Expansion  rad:  Expansion  quiet 
endif 
echo '  'Done' ' 
endif 

Create  your  hd-startup  file  and  store  it  in  the  S  directory  of  your  initial 
hard  disk  partition  (here  referenced  by  the  INIT:  name  assigned  in  the 
startup  lines  above).  The  hd-startup  will  mount  your  additional  parti- 
tions, transfer  control  to  them,  and  set  up  your  hard  disk  paths  and 
logical  assignments.  Below  is  a  sample  hd-startup  file.  This  can  be 
modified  to  correspond  to  your  hard  drive  system. 

;  Assign  system  directories  needed  to  mount  rest  of  partitions 

INITx/cd  INITx 

assign  DEVS:  INIT:Devs 

assign  L:      INIT:L 
In  this  example,  user  has  two  FFS  partitions,  FFO:  and  FF1: 
FFO:  contains  all  of  the  Workbench  directories.  We'll  assign  the 
logical  FASTWB:  to  the  partition  containing  the  Workbench  directories, 
and  H:  to  the  user's  work  partition  to  make  script  changes  easier. 

mount  FFO: 

mount  FF1: 

assign  FASTWB:  FFO: 

assign  H:  FF1: 

;  assign  all  system  directories  to  FASTWB: 

assign  c:  FASTWBx 

assign  SYS:      FASTWB: 

assign  DEVS:    FASTWB:Devs 

assign  LIBS:     FASTWB:Libs 

assign  L:  FASTWB:L 

assign  S:  FASTWB:s 

assign  C:  FASTWBx 

assign  Fonts:     FASTWB.fonts 

Now  copy  your  modified  MountList  to  the  devs  directory  of  your  initial 
partition  and  to  the  devs  directory  of  your  Workbench  partition.  Copy 
your  modified  Startup-Sequence  to  the  S  directory  of  both  your  initial 
partition  and  your  Workbench  partition.  (It  will  be  copied  from  the 
Workbench  partition  to  RAD:).  Turn  off  your  machine,  wait  30  sec- 
onds, then  reboot  with  your  modified  Workbench. 
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Small  Recoverable  Ramdrive  for  a  1  MB  Amiga 

This  small  ramdrive  is  not  suitable  for  rebooting  because  it  cannot  hold  all 
of  the  commands  and  handlers  required  during  startup.  It  is  somewhat 
useful  for  freeing  up  dfO:  because  it  holds  some  commonly  used  com- 
mands, the  s  directory,  and  the  Expansion  directory.  With  this  RAD:,  you 
will  also  be  able  to  start  a  NEWSHELL  from  the  command  line  or  from 
the  icon  in  the  ramdrive  without  having  to  insert  the  Workbench. 

With  this  modification,  the  startup  takes  a  couple  of  minutes  when  you 
power  on,  but  is  much  quicker  when  you  reboot. 

1.  Open  up  the  Workbench  disk  icon,  then  open  the  Prefs  drawer.  Click 
once  on  the  Pointer  icon  and  select  INFO  from  the  Workbench  menu. 
Change  the  Default  Tool  specification  from  SYS:Prefs/Preferences  to 
Preferences.  Press  RETURN,  then  click  on  SAVE  to  save  the  change. 
Now  repeat  this  procedure  with  the  Printer  and  Serial  icons. 

2.  Make  the  following  changes  in  the  devs/MountList  file: 

•  In  the  NEWCON:  entry,  add  this  line:  Mount  =  1 

•  In  the  RAD:  entry,  change  the  HighCyl  value  from  21  to  14,  and 
add  this  line:  BootPri  =  -129 

3.  Before  the  LoadWB  line  in  the  Startup-Sequence,  remove  the  follow- 
ing lines  (lines  18  and  19): 

Sys:System/SetMap  usal  ;  Activate  the  ( )/*  on  keypad 
path  ram:  c:  sys:  utilities  sys:  systems:  sys: prefs  add 

4.  Insert  the  following  lines  in  your  Startup-Sequence,  between  the 
FastMemFirst  and  BindDrivers  lines  (5  and  6).  You  may  wish  to 
modify  the  '  'copy' '  lines  of  the  following  script  to  place  some  different 
commands  in  the  ramdrive.  The  directories  and  some  of  the  com- 
mands (such  as  NEWSHELL,  ENDCLI,  RUN,  FORMAT  and  DISK- 
COPY)  are  required. 

failat  30 

assign  >NIL:  RAD:  exists 

if  warn 

echo  "Mounting  RAD:..."  NOLINE 

mount  RAD: 

if  not  exists  RAD:c 

echo  "Setting  up  RamDrive..."  NOLINE 

relabel  drive  RAD:  name  RamDrive 

makedir  RAD:c 

copy  c:assign|copy|delete|dir|echo|ed|else  RADx  quiet 

radx/copy  c:endcli|endif|if|info|makedir  RADx  quiet 

rad:c/copy  c:newshell|path|prompt|rename|run  RADx  quiet 

radx/copy  sys:  Utilities/More  radx  quiet 

radx/makedir  RAD:s 

radx/copy  s:  RAD:s  all  quiet 

radx/makedir  RAD:System 

radx/copy  sys:system/CLl|format|diskcopy  rad:System  quiet 

radx/copy  sys:Shell|Shell.info  RAD:  quiet 

radx/makedir  rad:  Expansion 
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radx/copy  sys:  expansion  rad:  Expansion  quiet 

endif 
endif 
failat  10 
assign  s:  RAD:s 

path  radx  rad:system  sys:utilities  sys:system  sys:prefs  sys:  s:  add 
Sys:System/SetMap  usal 
assign  sys:  RAD: 
echo  "Done" 
5.  Add  these  two  lines  before  the  LoadWb  line: 
path  c:  ram:  add 
assign  c:  radx 
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6.  UTILITIES  ON  THE  EXTRAS  DISK 

Tools 

The  Tools  drawer  contains  several  utilities  that  let  you  *  'work' '  with  your 
Amiga.  In  a  sense,  they  enhance  the  basic  capabilities  of  the  Workbench. 
With  these  programs,  you  can  modify  your  icons  and  fonts,  check  on  the 
system's  memory,  edit  text  files,  and  change  the  colors  of  an  Intuition 
screen.  The  Tools  drawer  includes: 

FED  —  for  modifying  existing  fonts  or  creating  new  ones 

FreeMap  —  for  displaying  your  chip  memory  usage 

IconEd  —  for  changing  the  appearance  of  icons 

IconMerge  —  for  merging  and  splitting  icon  images 

KeyToy2000  —  for  displaying  the  global  keymap  of  an  Amiga  2000 

MEMACS  —  for  editing  text  files 

Palette  —  for  changing  the  colors  of  an  Intuition  screen 

PerfMon  —  for  monitoring  the  system's  performance 

Each  of  these  utilities  is  explained  below,  except  for  MEMACS.  MEMACS 
is  such  a  powerful  and  complex  text  editor  that  it  requires  its  own  chapter. 
It  is  fully  explained  in  Chapter  7. 

FED 

FED  is  a  font  editor  for  changing  the  Workbench  fonts  or  for  creating  your 
own  new  fonts.  However,  if  you  plan  to  change  a  Workbench  font,  make 
sure  that  you  are  experimenting  with  a  copy  of  the  Workbench  disk. 
Once  you  make  any  changes,  you  will  be  unable  to  restore  the  original. 
Please  note,  FED  cannot  be  used  to  edit  color  fonts  or  a  font  that  is  larger 
than  32  pixels  in  either  dimension. 

When  you  double-click  on  the  FED  icon,  a  window  appears  filled  with 
gadgets,  boxes,  switches,  numbers  and  symbols.  There  is  also  a  menu  bar 
across  the  top  of  the  screen;  the  menus  are  Project,  Edit  and  Attributes. 
You  will  do  all  of  your  creating/editing  in  this  window.  All  the  menu  items 
and  gadgets  are  described  below. 

If  you're  going  to  edit  a  Workbench  font,  the  first  thing  you'll  want  to  do  is 
to  load  the  font  into  FED.  To  do  this,  select  Open  from  the  Project  menu. 
A  requester  will  appear  listing  the  available  fonts.  Select  the  one  you  want 
to  load  and  choose  Load  It.  If  you  change  your  mind,  choose  Whoops!  (If 
you  want  to  work  on  a  brand  new  font,  select  New  instead  of  Open.) 

Each  character  of  the  font  appears  in  one  of  the  character  boxes  to  the 
right  side  of  the  screen.  You  can  only  see  a  limited  number  of  boxes  at  a 
time,  there  are  actually  more  than  200  boxes  for  a  typical  font.  The 
character  box  reflects  the  current  appearance  of  a  character.  As  changes 
are  made,  the  display  in  the  character  box  also  changes. 

Each  character  is  made  up  of  a  series  of  dots.  Each  dot  represents  one 
pixel  of  the  character.  You  use  the  mouse  to  edit  (or  create)  a  character  in 
the  large  edit  box  that  fills  the  left  side  of  the  screen. 
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•  To  change  a  dot,  click  on  it  with  the  mouse. 

•  To  draw  dots,  click  on  any  off  dot,  then  drag  the  mouse. 

•  To  erase  dots,  click  on  any  on  dot,  then  drag  the  mouse. 

Each  of  the  gadgets  is  briefly  explained  so  that  you  understand  their 
functions.  Then  you  should  let  your  artistry  and  imagination  lead  you  in 
producing  show-stopping  fonts. 

The  Gadgets 

LoRes  switch  —  selects  either  320  x  200  or  640  x  200  resolution. 

Grid  switch  —  turns  the  edit  box  grid  on  or  off. 

Scroll  diamond  —  if  a  character  is  larger  than  the  display  area  of  the  edit 
box,  you  can  move  to  the  outer  limits  of  the  box  by  clicking  on  the  arrows 
of  the  scroll  diamond.  The  character  will  move  only  if  its  outer  edge  is  not 
displayed.  For  instance,  you  cannot  move  a  character  to  the  left  if  you  can 
already  see  its  left  edge  —  even  if  that  edge  is  not  at  the  edge  of  the  edit 
box. 

Zoom  —  allows  you  to  select  the  display  size  of  the  edit  box. 

Left/Right  triangles  —  shifts  the  current  character  to  the  left  or  right  by 
one  pixel. 

Up/Down  triangles  —  shifts  the  current  character  up  or  down  by  one 
pixel. 

R  —  reverses  the  character. 

Left/Right  arrow  —  flips  the  character  to  the  left  or  the  right. 

Up/Down  arrow  —  flips  the  character  up  or  down. 

The  Boxes 

The  boxes  set  the  specific  parameters  for  a  font.  For  more  explanation  of 
these  parameters,  consult  the  Text  chapter  of  the  Addison-Wesley  ROM 
Kernel  Manual:  Libraries  and  Devices. 

The  Lo  and  Hi  boxes  —  determine  the  number  of  characters  in  a  font  or 
the  character  range  (i.e.,  which  characters  to  save).  For  instance,  you 
could  have  a  range  that  only  included  capital  letters  or  a  range  that 
included  only  numerical  symbols.  The  range  for  the  fonts  on  the  Work- 
bench is  from  032  to  255. 

Kern  —  determines  the  kerning  data;  this  is  usually  set  to  zero. 

Space  —  determines  the  proportional  spacing  information  or  the  width  of 
each  character  rectangle  —  how  many  pixels  of  space  the  character  will 
fill  on  the  screen. 

Width  —  works  with  the  Space  variable  to  determine  the  proportional 

spacing  information  —  how  many  pixels  of  actual  data  are  present  for  the 

character. 

Kern,  Space  and  Width  can  only  be  changed  for  proportional  fonts. 
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BLine  —  specifies  the  baseline  of  the  characters.  The  baseline  is  repre- 
sented by  the  green,  horizontal  line  in  the  edit  box.  This  represents  the 
number  of  grid  blocks  from  the  top  of  the  character  to  the  baseline.  Think 
of  the  baseline  as  a  ruled  line  on  a  piece  of  paper. 

XSize  —  represents  the  nominal  width  of  a  font. 

YSize  —  represents  the  nominal  height  of  a  font. 

The  Project  Menu 

New  —  clears  the  character  boxes  allowing  you  to  start  fresh. 

Open  —  lists  the  available  fonts  and  lets  you  load  one. 

Save  —  saves  the  font  that  you've  been  working  on  under  its  original 
name. 

Save-as  —  lets  you  save  a  font  under  a  new  name. 

About  —  lists  credits. 

Quit  —  exits  FED. 

The  Edit  Menu 

NOTE:  The  items  in  this  menu  affect  the  ENTIRE  font  and  some  of  them 
are  very  difficult  to  reverse. 

Make  italic  —  algorithmically  italicizes  the  entire  font. 

Make  bold  —  algorithmically  changes  the  entire  font  to  boldface. 

Make  underlined  —  algorithmically  underlines  the  entire  font. 

Copy  to  —  copies  a  character  from  one  character  box  to  another.  To  use 
this  option,  select  a  character  box,  for  example  K,  then  choose  Copy  To. 
When  you  select  another  character  box,  the  K  will  be  copied  into  that 
box.  Until  you  select  Copy  To  again,  the  pointer  will  remain  a  '  'Copy' ' 
pointer,  and  each  box  you  select  will  receive  a  copy  of  the  originally 
selected  character  box.  The  copy  mode  will  remain  in  effect  until  you 
select  Copy  To  again. 

Erase  —  erases  the  character  from  the  selected  character  box. 

All  right  —  shifts  all  characters  to  the  right  by  one  pixel. 

All  left  —  shifts  all  characters  to  the  left  by  one  pixel. 

All  up  —  shifts  all  characters  up  by  one  pixel. 

All  down  —  shifts  all  characters  down  by  one  pixel. 

The  Attributes  Menu 

This  menu  lets  you  set  the  type  and  style  bits  of  the  font. 

Font  Type  —  choose  either  Proportional  or  Fixed  width  spacing. 

Font  Style  —  choose  Normal,  Italic,  Bold,  Underlined,  or  Extended.  For 
most  fonts,  select  Normal.  If  you  design  a  special  italic  font,  for  instance, 
set  the  italic  flag.  When  the  system  finds  a  specially  designed  italic  font,  it 
will  use  it  instead  of  trying  to  create  its  own. 

The  Extras  Disk  6-3 


FreeMap 

FreeMap  gives  a  graphic  display  of  chip  memory  usage,  showing  the 
blocks  used  and  the  free  holes.  Each  pixel  in  the  map  area  represents  a 
64  byte  block.  If  all  the  bytes  in  a  block  are  free,  the  pixel  is  dark.  If  a  byte 
is  not  free,  the  pixel  is  light.  At  the  bottom  of  the  window,  the  amount  of 
free  CHIP  RAM  and  FAST  RAM  is  listed. 

To  quit  FreeMap,  choose  Please  from  the  Quit  menu.  Selecting  the  Info 
menu,  brings  up  a  brief  explanation  of  FreeMap. 

IconEd 

IconEd  lets  you  change  the  appearance  of  the  Workbench  icons.  It  has 
been  moved  to  the  Extras  disk  from  the  Workbench's  System  drawer. 
IconEd  is  fully  documented  in  your  Introduction  to  the  Commodore- 
Amiga  manual 

IconMerge 

IconMerge  lets  you  merge  the  images  of  two  single-image  Workbench 
icons.  It  also  lets  you  split  a  double-image  icon  into  two  single-image 
icons.  A  double-image  icon  is  an  icon  that  changes  its  shape  when  it  is 
selected. 

When  you  double-click  on  the  icon,  the  IconMerge  window  appears  and 
prompts  you  to  enter  either  an  m,  to  merge  two  single-image  icons,  or  an 
s,  to  split  a  double-image  icon.  For  example,  to  merge  the  ICONED  icon 
with  the  FED  icon,  enter  an  m  at  the  prompt,  and  you'll  get  the  following 
response: 

MERGE:  Iconl,  Icon2  (merge)->  Icon3 

Enter  all  icon  filenames  without  ".info." 
Iconl: 

At  the  prompt  after  Iconl:,  enter  '  'IconEd' '  and  hit  RETURN.  A  second 
prompt  will  appear  for  Icon2:,  enter  "FED".  For  Icon3:,  enter  "Test". 
IconMerge  will  merge  the  two  icons  and  the  window  will  quickly  disap- 
pear. 

To  see  your  new  icon,  you  must  close  and  re-open  the  Tools  window. 
The  new  test  icon  will  be  on  top  of  the  IconEd  icon.  Simply  drag  the  test 
icon  to  an  empty  space  in  the  window.  Notice  that  the  test  icon  is  an  exact 
copy  of  the  IconEd  icon  (Iconl).  When  you  click  on  the  test  icon,  the  FED 
image  (Icon2)  will  appear  to  show  that  the  icon  is  selected. 

The  IconMerge  icon  is  a  double-image  icon.  Try  splitting  that  icon. 
Double-click  on  the  IconMerge  icon  to  open  the  IconMerge  window. 
Enter  an  s  at  the  merge/split  prompt,  and  the  following  display  will 
appear: 

SPLIT:  Iconl  (split)->  Icon2,  Icon3 

Enter  all  icon  filenames  without  ".info.": 
Iconl: 
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Enter  IconMerge  at  the  Iconl:  prompt,  Icon  for  Icon2:,  and  Merge  for 
Icon3:.  After  the  IconMerge  window  disappears,  close  the  Tools  window, 
then  re-open  it.  The  two  new  icons,  Icon  and  Merge,  will  be  behind  the 
original  IconMerge  icon. 

Drag  them  to  an  empty  space  in  the  window  (or  select  Clean-up  from  the 
Workbench's  Special  menu).  Icon  will  reflect  the  unselected  appearance 
of  the  IconMerge  icon.  Merge  will  reflect  the  highlighted  appearance  of 
IconMerge. 

When  you  select  either  of  these  new  icons,  they  are  simply  highlighted. 
They  don't  change  form  like  a  double-image  icon  would.  Splitting  a 
double-image  icon  allows  you  to  use  IconEd  on  each  of  the  images.  Your 
modified  images  may  then  be  merged  back  together  with  the  merge 
option  of  IconMerge. 

To  run  IconMerge  from  the  CLI,  the  format  is: 

ICONMERGE  [<iconl>  <icon2>  <icon3>  [OPTS]] 

The  default  for  IconMerge  is  to  merge  the  two  icons.  If  no  icons  are 
specified,  the  IconMerge  window  will  appear  and  you  can  proceed  as 
outlined  above.  If  you  specify  OPT  S,  IconMerge  will  split  the  icons 
named  as  <iconl>  and  <icon2>. 

A  Few  Things  to  Remember: 

1)  Icon  names  must  be  entered  without  the  .info  suffix. 

2)  When  merging  icons,  be  sure  they  are  the  same  size. 

KeyToy2000 

Double-clicking  on  the  KeyToy2000  icon  results  in  a  display  of  the 
current  global  keymap  for  the  keyboard  accompanying  the  Amiga  2000 
computer. 

The  initial  display  reflects  the  characters  that  are  output  when  each  key  is 
pressed  alone.  To  see  the  characters  that  are  output  when  qualifier  keys 
are  pressed  simultaneously  with  a  character  key,  either  click  on  the 
corresponding  gadget  in  the  KeyToy  display  or  hit  the  key  on  the  key- 
board. The  qualifier  keys  are  Control,  both  Shifts,  and  both  Alts. 

The  following  list  is  a  guide  to  interpreting  the  KeyToy  display: 

•  All  KeyToy  keys  labeled  in  blue  are  not  used  by  KeyToy  (That's 
why  CTRL,  SHIFT  and  ALT  appear  in  blue  in  the  initial  display. 
After  you  select  one  or  more  of  these  keys,  the  label  changes 
color.) 

•  Any  key  labeled  in  red  is  a  dead  key,  except  for  the  two  AMIGA 
keys  and  the  CAPS  LOCK  key. 

•  Any  key  labeled  in  bold-italic  is  deadable. 

•  Any  key  labeled  with  $$  is  defined  by  a  character  string  longer 
than  one  character. 

•  A  character  preceded  by A  or  ~  is  a  control  character. 

•  If  a  key  is  blank,  it  is  undefined  for  the  current  choice  of  qualifier(s). 

The  Extras  Disk  5.5 


Palette 

With  Palette  you  can  modify  the  colors  of  a  screen.  It  differs  from  the 
color  setting  capabilities  of  Preferences  in  that  Preferences  is  limited  to  the 
colors  of  the  Workbench  screen.  However,  color  changes  made  with 
Palette  are  only  temporary.  They  cannot  be  saved  to  disk. 

To  open  Palette  from  the  Workbench,  double-click  on  its  icon.  The 
Palette  Tool  window  will  appear  in  the  frontmost  screen,  usually  your 
Workbench  screen.  To  modify  the  colors  of  a  different  screen,  you  need 
to  bring  that  screen  to  the  front  of  the  display  before  opening  Palette. 
Open  the  desired  screen,  then  slide  it  down  so  that  the  Workbench  screen 
is  also  visible.  Open  the  Tools  window  on  the  Workbench  screen,  and 
double-click  on  the  Palette  icon.  When  the  Palette  Tool  window  opens,  it 
will  be  on  the  frontmost  screen. 

To  run  Palette  from  the  CLI,  the  format  is: 

PALETTE  [<bitplanes>]  [<screentype>] 

By  specifying  values  for  the  <bitplanes>  and  <screentype>  options  you 
can  open  a  custom  test  screen.  The  values  for  <bitplanes>  and  <screen- 
type>  are  as  follows: 

<bitplanes>  specifies  the  depth  of  the  test  screen;  1=2  colors, 
2  =  4  colors,  3  =  8  colors,  4  =  16  colors,  and  5 
=  32  colors 

<screentype>  specifies  the  resolution  of  the  test  screen;  0  =  320 
x  200  pixels,  1  =  320  x  400  (interlaced  screen),  2 
=  640  x  200,  and  3  =  640  x  400  (interlaced 
screen) 

NOTE:  The  value  for  <bitplanes>  is  restricted  to  4  or  less  if  the  value  for 
<screentype>  is  equal  to  either  2  or  3. 

The  Palette  Tool  window  contains  several  gadgets  and  sliders.  Across  the 
top  of  the  window  are  color  rectangles  showing  the  colors  that  can  be 
modified.  Beneath  these  rectangles  are  three  color  sliders:  red,  blue  and 
green.  Select  a  color  rectangle  to  be  modified,  then  drag  the  color  sliders 
until  you  have  the  color  you  want.  The  color  changes  are  reflected  in  the 
vertical  box  that  runs  alongside  the  color  sliders.  Repeat  this  process  with 
each  color  rectangle  until  you  have  the  screen  configured  as  you  want  it. 

Choose  the  OK  box  to  implement  the  color  change.  Choose  RESET  to 
return  the  colors  to  their  original  states.  Or  choose  CANCEL  to  quit 
Palette  without  making  any  changes.  WARNING:  If  you  open  Palette  on 
a  screen  other  than  the  Workbench  screen,  you  must  first  close  Palette 
before  exiting  or  closing  the  application  that  opened  the  new  screen. 
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PerfMon 

Double-click  on  the  PerfMon  icon,  and  the  Performance  Monitor  window 
appears.  The  top  portion  of  the  window  shows  the  amount  of  CPU  time 
currently  in  use  (calibrated  for  a  68000  CPU).  The  black  center  line 
indicates  100%  CPU  utilization.  The  bottom  portion  of  the  window  shows 
the  amount  of  CHIP  RAM  currently  in  use.  The  bottom  black  line 
indicates  100%  chip  memory  utilization.  The  amount  of  fast  memory 
available  is  displayed  at  the  bottom  of  the  window. 

You  can  choose  the  time  interval  for  the  performance  update  from  the 
PM  Menu.  The  options  are:  .5,  1  and  2  seconds. 


PC  Utilities 


PC  Utilities  allows  you  to  use  a  blA"  floppy  disk  drive  with  your  Amiga 
system.  With  a  bV*  disk  drive  you  can  copy  files  from  a  PC  to  your 
Amiga,  and  vice  versa.  In  many  cases  when  you  add  an  expansion  device 
to  your  system,  such  as  a  hard  disk,  you  must  MOUNT  it  —  tell  the  Amiga 
of  its  existence  by  adding  a  command  to  your  startup-sequence.  Howev- 
er, you  do  not  need  to  do  this  to  use  PC  Utilities.  If  you  do  MOUNT  the 
5*A"  drive,  PC  Utilities  will  not  work  correctly. 

If  you  get  a  message  telling  you  that  5  W  drives  are  not  available,  double- 
check  that  your  drive  is  connected  properly  and  that  it  is  turned  on.  Also, 
be  sure  to  boot  the  computer  after  your  bW  drive  has  been  connected  to 
the  system. 

PCCopy 

PCCopy  lets  you  copy  files  from  a  5V4"  PC  disk  onto  a  3Vfe"  Amiga  disk. 
When  you  open  PCCopy,  a  window  appears  so  that  you  can  enter  the 
names  of  the  files  you  want  to  copy.  The  files  in  the  root  directory  of  the 
5  W  disk  will  be  displayed.  You  can  either  click  on  the  name  of  the  file  to 
have  it  appear  in  the  FROM  gadget,  or  type  it  in.  You  must  also  enter  the 
name  of  the  Amiga  file  you  want  as  the  destination.  Be  sure  to  enter  the 
complete  path  of  both  files. 

When  copying  to  an  Amiga  disk,  you  cannot  create  a  new  directory  or 
subdirectory.  Any  directories  specified  must  already  exist  on  the  disk.  To 
create  a  new  directory,  either  duplicate  the  Empty  drawer  and  rename  it 
or  use  the  AmigaDOS  MAKEDIR  command. 

After  the  correct  filenames  are  entered,  click  on  the  COPY  gadget.  A  new 
box  will  display: 

Total  bytes  to  copy  <xxxxx> 
Bytes  copied  so  far  <xxxxx> 

The  number  of  bytes  will  be  updated  throughout  the  copying  process.  To 
exit  PCCopy  either  select  CANCEL  or  click  in  the  window's  close  gadget. 
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PCFormat 

If  you  are  going  to  copy  a  file  from  an  Amiga  disk  to  a  5W  disk  using 
ToPCCopy,  the  5V4"  disk  must  be  formatted  properly  by  using  PCFor- 
mat When  you  open  PCFormat,  a  window  will  appear  displaying  options 
for  Drive,  DOS  Version,  Sides,  and  Sectors/Track.  In  general,  you  do  not 
need  to  change  the  default  settings  that  are  present  However,  you  may 
want  to  specify  a  volume  name  for  the  disk.  To  do  this,  simply  type  a 
name,  and  it  will  appear  at  the  prompt  in  the  Volume  Name  gadget 

To  begin  formatting  the  disk,  make  sure  a  disk  is  in  the  drive  and  click  in 
the  Format  gadget.  DO  NOT  start  formatting  if  there  is  no  disk  in  the 
drive.  A  box  will  appear  to  let  you  know  that  the  formatting  is  in  progress: 

Formatting  Track  <xx> 
Tracks  Remaining  <xx> 

After  each  track  is  formatted,  the  utility  then  goes  through  and  verifies 
each  track.  If  you  need  to  save  time,  you  can  select  the  Abort  gadget 
during  the  verifying  process. 

ToPCCopy 

ToPCCopy  lets  you  copy  files  from  a  3 W  Amiga  disk  to  a  5V4"  PC  disk. 
When  you  open  ToPCCopy,  a  window  appears  with  gadgets  that  let  you 
enter  the  complete  path  for  the  FROM  (Amiga)  file  and  the  TO  (PC)  file. 
The  files  that  are  included  on  the  Amiga  disk  will  be  displayed  in  the  box 
in  the  bottom-half  of  the  window.  If  you  click  on  the  name  of  the  file,  it 
will  automatically  appear  in  the  FROM  gadget. 

If  you  want  to  create  a  subdirectory  on  the  PC  disk,  include  the  new 
directory  in  the  path  you  are  entering  in  the  TO  gadget. 

After  you  have  entered  the  correct  file  names,  click  in  the  COPY  gadget. 
Just  as  with  PCCopy,  a  box  will  appear  displaying: 

Total  bytes  to  copy  <xxxxx> 
Bytes  copied  so  far  <xxxxx> 

This  information  will  be  updated  as  the  copying  process  continues.  When 
copying  is  complete,  click  on  the  CANCEL  gadget  to  exit. 

Filtering 

When  copying  vanilla  ASCII  files  between  the  Amiga  and  the  PC,  you 
may  want  to  take  advantage  of  the  text  filtering  gadget.  Your  options  are 
Text-7,  Text-8,  and  OFF.  When  you  copy  an  ASCII  file  using  Text-7,  the 
data  does  not  have  the  high  bit  in  the  byte  set.  Text-8  includes  the  high 
bit. 
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7.  MEMACS 


MEMACS  (which  stands  for  MicroEmacs  and  is  pronounced  M-Emacs)  is 
a  screen-oriented  editor  that  allows  you  to  edit  multiple  files  at  one  time. 
The  only  restriction  is  that  the  entire  body  of  each  file  must  be  able  to  fit 
into  memory  at  one  time,  since  MEMACS  performs  all  of  its  operations 
on  memory  resident  text. 

The  length  of  the  lines  you  can  edit  is  limited  to  80  characters.  Characters 
beyond  the  80th  character  of  the  line  are  not  lost;  they  simply  do  not 
show  on  the  screen.  The  only  way  to  see  those  characters  is  to  break  the 
line  or  to  delete  some  of  the  displayed  characters.  When  entering  new 
characters,  you  can  keep  typing  past  the  80th  character  of  a  line,  but  what 
you  type  will  not  show  on  the  screen. 

You  can  run  MEMACS  from  both  the  Workbench  and  the  CLI.  From  the 
Workbench,  double-click  on  the  icon.  From  the  CLI,  the  format  is: 

MEMACS  [<filename>]  [goto  <n>]  [OPT  W] 

[<filename>]    specifies  the  file  to  read  into  MEMACS 

[goto  <n>]       specifies  that  the  cursor  should  appear  on  the  nth 
line  of  the  file 


[OPTW] 


opens  MEMACS  in  a  Workbench  window 


Notational  Conventions  and  Special  Terminology 

Throughout  this  chapter  certain  key  combinations/sequences  will  be  re- 
ferred to  in  the  following  manner: 

A(char)  A  caret  (A)  followed  by  a  character  is  a  '  'Con- 

trol-key combination.' '  This  means  that  you 
should  hold  down  the  control  key  as  you  press 
the  designated  character  key. 

'(char)'  Whenever  apostrophes  enclose  a  character,  it 

means  that  upper  or  lower  case  does  not  matter. 
It  is  the  keycap  itself  that  selects  the  function. 
(This  notation  is  widely  used  in  the  summary  at 
the  end  of  this  chapter.) 

<ESC>  Represents  the  Esc  (Escape)  key  on  your  Amiga 

keyboard. 

<DEL>  Represents  the  Del  (Delete)  key  on  your  Amiga 

keyboard. 

<TAB>  Represents  the  Tab  key  on  your  Amiga 

keyboard. 

<RETURN>  Represents  the  Return  key  on  your  Amiga 

keyboard. 
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There  are  some  special  terms  associated  with  MEMACS  that  you  should 
be  familiar  with: 


Buffer: 


Dot: 
Mark: 


Kill: 


Yank: 


Window: 


Read  a  File: 


A  memory  area  that  MEMACS  controls.  There  is 
always  at  least  one  buffer  used  by  MEMACS, 
and  it  will  contain  zero  or  more  characters  of 
text. 

The  current  cursor  position. 

A  cursor  position  that  you  can  specify.  (Each 
buffer  has  its  own  dot  and  mark.)  The  menu 
item  Set-mark  allows  you  to  *  'mark' '  the  current 
cursor  position.  You  can  then  move  forward  or 
backward  in  the  file,  adding  or  deleting  text. 
Then,  when  you  wish  to  return  to  the  place  that 
you  "marked",  you  simply  select  the  Swap- 
dot&mark  command. 

You  can  also  set  a  mark  to  indicate  the  begin- 
ning of  a  block  of  text  that  you  want  to  duplicate, 
move,  or  delete.  The  '  'block' '  will  encompass  all 
the  characters  starting  with  the  mark  and  con- 
tinuing to  the  current  cursor  position. 

Kill  commands  remove  text  from  the  screen  and 
save  it  in  a  kill  buffer.  This  text  can  be  retrieved 
and  put  back  into  your  document  by  using  the 
Yank  command.  As  you  issue  successive  Kill 
commands  (without  selecting  Yank  in  between), 
each  block  of  text  that  you  kill  will  be  added  to 
the  existing  text  in  the  kill  buffer. 

The  Yank  command  copies  the  contents  of  the 
current  kill  buffer  to  the  line  just  above  the  one  in 
which  the  cursor  is  positioned.  You  can  copy  a 
block  of  text  from  one  buffer  to  another  by  killing 
that  block,  then,  without  moving  the  cursor, 
immediately  Yanking  it  back  into  the  same  buff- 
er. Move  the  cursor  to  a  new  position,  and 
choose  Yank  again.  The  text  you  want  to  copy 
will  still  be  in  the  kill  buffer  and  will  remain  there 
until  you  mark  and  kill  another  block  of  text. 

A  window  in  MEMACS  is  somewhat  different 
than  an  Intuition  window  in  Workbench.  In 
MEMACS,  the  screen  can  be  split  into  multiple 
slices  so  that  you  can  edit  and  display  more  than 
one  buffer  or  two  or  more  portions  of  the  same 
buffer.  Each  '  'slice' '  is  a  MEMACS  window. 

When  you  ask  MEMACS  to  read  a  file  (using  the 
menu  command  Read-file),  the  contents  of  the 
current  buffer  are  replaced  with  the  contents  of 
the  file  you  want  to  read. 
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Visit  a  File: 


Select  Buffer: 


Modified  Buffers: 


If  you  want  to  access  a  new  file  without  replacing 
the  contents  of  the  current  buffer,  you  can  ask 
MEMACS  to  visit  a  file  (using  the  Visit-file  com- 
mand). MEMACS  assigns  a  new  buffer  to  the  file 
you  are  visiting. 

You  can  switch  back  and  forth  between  the  buff- 
ers you  are  working  with  by  choosing  the  Select- 
buffer  command  and  specifying  the  name  of  the 
buffer  you  wish  to  use.  MEMACS  sometimes 
assigns  a  shorter  name  to  a  buffer  than  the  file- 
name to  which  it  corresponds.  Be  careful  to 
specify  the  correct  buffer  name  when  you  want 
to  switch  back  and  forth. 

When  you  make  any  changes  to  a  buffer,  even  if 
you  only  hit  <RETURN>  then  delete  it,  ME- 
MACS remembers  and  will  mark  that  buffer  as  a 
modified  buffer. 

You  can  see  which  buffers  have  been  modified 
by  using  the  List-buffers  command.  Any  modi- 
fied buffers  are  signified  with  an  asterisk  (*).  If 
you  try  to  exit  MEMACS  without  saving  any 
changes,  a  prompt  will  tell  you  that  modified 
buffers  exist  and  will  ask  you  if  you  really  want  to 
quit.  Once  you  save  a  buffer,  the  modified  status 
is  removed. 


Opening  MEMACS 


When  you  open  MEMACS,  a  new  screen  appears.  At  the  bottom  of  this 
screen  are  the  words  "MicroEMACS  —  main".  This  line  displays  the 
name  of  the  buffer  that  is  currently  in  use.  In  this  case,  it  is  the  '  'main' ' 
buffer.  Remember,  a  buffer  contains  zero  or  more  characters  of  text. 

Usually  you  will  invoke  MEMACS  with  a  filename  specified.  If  the  file 
exists,  it  will  be  read  into  a  buffer.  Otherwise,  the  file  will  be  created  when 
you  save  your  work. 

You  can  have  several  buffers  in  use  at  one  time,  and  you  can  show  one  or 
more  on  the  screen  at  the  same  time.  Menu  options  let  you  switch  back 
and  forth  between  them.  At  all  times,  what  you  see  on  the  screen  is  what 
is  actually  in  the  buffer. 

If  the  contents  of  a  buffer  have  been  either  read  from  or  written  to  a  file, 
that  buffer  will  be  associated  with  that  file.  In  this  case,  the  bottom  line  of 
the  screen  will  display  the  name  of  the  buffer  along  with  the  filename  with 
which  it  is  associated. 
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MEMACS  has  two  modes  of  operations:  normal  and  command.  When 
MEMACS  is  in  normal  mode,  you  can: 

•  move  the  cursor  using  the  cursor  keys 

•  move  the  cursor  to  the  edge  of  the  window  by  holding  down  the 
SHIFT  key  and  pressing  the  appropriate  cursor  key 

•  move  the  cursor  by  clicking  the  left  mouse  button  in  the  desired 
place  on  the  screen 

•  insert  characters  at  the  current  cursor  position  simply  by  typing 
them 

•  delete  the  character  at  the  current  cursor  position  by  pressing 
<DEL> 

•  delete  the  character  to  the  left  of  the  cursor  by  pressing 
<BACKSPACE> 

•  perform  other  special  functions  as  explained  in  the  menu  section 
and  command  summaries  that  follow 

When  MEMACS  is  in  command  mode,  the  cursor  jumps  to  the  bottom 
line  of  the  display,  and  the  program  asks  you  for  certain  additional 
information.  The  command  mode  is  entered  through  various  menu  items 
which  are  explained  later. 

Mouse  Commands 

You  can  also  use  the  mouse  to  interface  with  MEMACS.  If  the  MEMACS 
window  is  inactive,  clicking  in  it  with  the  mouse  will  activate  the  window. 
You  can  then  move  the  cursor  by  moving  the  mouse's  pointer  to  the  spot 
where  you  want  the  cursor  to  be  and  clicking  the  left  mouse  button.  You 
can  also  use  the  mouse  to  switch  between  buffers.  However,  to  do  this 
both  buffers  must  be  visible  on  the  screen. 

MEMACS  Menus 

MEMACS  offers  the  following  main  menu  items: 

Project    —  system  and  file-oriented  items 

Edit        —  file  editing  commands 

Window  —  controls  the  characteristics  of  the  MEMACS  windows 

Move      —  controls  the  placement  of  the  cursor 

Line        —  line-oriented  operations 

Word      —  word-oriented  operations 

Search    —  search  and  search/replace  options 

Extras     —  controls  the  numerical  value  of  arguments,  and  lets  you 

execute  a  series  of  operations  as  though  it  was  a  single 

special  command 

This  section  will  explain  each  of  these  menus  and  their  commands.  Each 
of  the  commands  also  has  a  keyboard  shortcut.  The  shortcuts  appear  in 
the  menus,  to  the  right  of  the  command,  and  in  this  text,  along  the  right- 
hand  margin. 
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The  Project  Menu 


The  commands  in  the  Project  menu,  except  for  Visit-file,  affect  the  buffer 
associated  with  the  current  cursor  position. 

Rename  AXF 

Changes  the  name  of  the  file  associated  with  the  current  buffer.  This 
command  is  useful  if  you  are  saving  versions  of  a  program  or  text  file 
as  you  go  along.  You  can  perform  a  Save  command  for  the  first 
version,  modify  a  few  things,  Rename  the  file  associated  with  this 
buffer,  and  then  save  the  new  version. 

When  you  select  Rename,  MEMACS  prompts: 

New  file  name: 

If  you  simply  press  <RETURN>  without  specifying  a  filename,  the 
buffer  becomes  disassociated  with  any  filename.  You  must  specify  a 
name  here  if  you  want  the  buffer  to  be  appropriately  associated  with 
a  file. 

Read-file  TR 

Replaces  the  contents  of  the  current  buffer  with  the  contents  of  a  file. 
When  you  select  Read-file,  MEMACS  moves  the  cursor  to  the 
bottom  line  of  the  display  and  requests: 

Read  File: 

Enter  the  complete  path  of  the  file,  including  the  volume  name, 
directory,  and  file,  then  press  <RETURN>.  The  file  is  read  into  the 
current  buffer,  overwriting  the  data  that  was  stored  there. 

If  you  do  not  want  to  read  a  file,  simply  press  <RETURN>  without 
specifying  a  filename.  MEMACS  will  ignore  the  request  and  return 
you  to  normal  mode. 

Visit-file  XV 

Lets  you  work  with  additional  files,  aside  from  the  first  file  you  open. 
You  must  already  be  editing  something  before  you  can  visit  another 
file.  This  command  is  useful  for  programmers  who  are  creating  a 
program  and  want  to  extract  pieces  from  or  refer  to  other  programs. 

When  you  issue  this  command,  MEMACS  moves  the  cursor  to  the 
bottom  line  and  asks: 

Visit  File: 

Type  the  complete  path  of  the  file,  and  hit  <RETURN>.  MEMACS 
will  read  the  file  into  a  buffer,  if  it  is  not  already  there.  If  the  file  you 
want  to  visit  is  on  a  different  disk,  AmigaDOS  will  display  a  requester 
asking  you  to  insert  that  particular  disk  into  any  drive.  If  the  file  is 
already  in  a  buffer,  MEMACS  will  switch  you  to  that  buffer 
automatically. 
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Insert-file  XI 

Inserts  the  contents  of  a  file  into  the  current  buffer.  When  you  issue 
this  command,  MEMACS  moves  the  cursor  to  the  bottom  line  and 
asks: 

Insert  File: 

Enter  the  complete  path  of  the  file  to  use,  and  hit  <RETURN>. 
MEMACS  will  read  it  into  the  current  buffer  at  a  point  one  line  above 
the  current  cursor  position. 

Save-file  TS 

Writes  the  contents  of  the  current  buffer  to  the  filename  associated 
with  that  buffer.  The  filename  associated  with  the  buffer  was  deter- 
mined when  the  contents  of  an  existing  file  were  read  to  the  file 
(Read-file)  or  when  the  file  associated  with  the  current  buffer  was 
renamed  (Rename). 

If  there  is  no  filename  specified  on  the  status  line,  MEMACS  tells  you 
*  'No  File  Name* '  and  refuses  to  perform  the  save. 

After  a  successful  Save,  MEMACS  uses  the  bottom  line  of  the  screen 
to  tell  you  how  many  lines  it  has  written  out  to  the  designated  file. 

Save-as-file  TW 

Allows  you  to  specify  the  name  of  a  file  to  associate  with  a  buffer. 
When  you  issue  this  command,  MEMACS  prompts: 

Write  File: 

MEMACS  is  requesting  the  name  of  the  file  in  which  it  should  save 
the  current  contents  of  the  buffer.  If  you  provide  a  complete  path 
and  press  <RETURN>,  the  buffer  will  be  written  out  to  that  file.  (If 
you  don't  provide  a  name  and  press  <RETURN>,  you  are  returned 
to  normal  mode.)  On  the  status  line  for  the  buffer,  the  following 
notation  will  appear: 

File:    <filename> 

From  now  on,  that  file  will  be  used  to  save  the  current  contents  of 
this  buffer  when  you  issue  a  Save  command. 

Save-mod  AXAM 

Writes  the  contents  of  all  modified  buffers  to  the  disk.  Use  this  item 
with  caution  to  be  sure  that  you  don't  accidentally  modify  a  buffer 
associated  with  a  file  you  have  visited  but  don't  intend  to  change. 

Save-exit  XT 

Saves  all  modified  buffers  then  exits  MEMACS.  It  is  simply  a  combi- 
nation of  the  Save  and  Quit  items.  Again,  use  this  item  with  caution 
(see  Save-mod). 
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New-CLI 

Brings  up  an  entirely  new  CLl  window  called  "Spawn  Window." 
You  can  issue  as  many  CLI  commands  in  the  spawn  window  as  you 
want  without  interfering  with  MEMACS.  To  return  to  MEMACS,  use 
the  ENDCLI  command.  The  spawn  window  disappears,  and  ME- 
MACS is  restored  to  its  previous  state. 

CLI-Command  X! 

Allows  you  to  execute  an  AmigaDOS  command  while  you  are  still  in 
MEMACS.  It  is  similar  to  issuing  a  RUN  command  while  in  the  CLL 
When  you  select  this  menu  item,  MEMACS  moves  the  cursor  to  the 
bottom  of  the  screen  and  provides  you  with  a  prompt  (!).  You  can 
then  type  a  command  for  AmigaDOS  to  process  on  this  line.  ME- 
MACS temporarily  suspends  operation,  and  AmigaDOS  executes 
your  command.  The  output  of  the  command  appears  in  a  temporary 
buffer  called  spawn,  output. 

Quit  AC 

Exits  MEMACS.  If  one  or  more  of  the  buffers  has  been  modified 
since  you  last  saved  it  to  a  file,  MEMACS  prompts: 

Modified  buffers  exist,  do  you  really  want 
to  exit?  [y/n]? 

MEMACS  is  giving  you  a  last  chance  to  save  your  work.  If  you  don't 
want  to  exit,  simply  press  <RETURN>.  If  you  do  want  to  quit,  you 
must  press  the  'y'  key  then  hit  <RETURN>. 

Before  quitting,  you  can  check  which  buffers  MEMACS  is  referring 
to  by  selecting  List-buffers  in  the  Edit  menu.  MEMACS  lists  the 
names  associated  with  each  buffer  and  shows  an  asterisk  by  each 
buffer  that  has  been  modified  since  you  last  saved  it  to  disk. 

There  are  circumstances  under  which  you  will  not  want  to  save  all 
buffers  back  to  the  original  files.  For  example,  let's  say  you  were 
writing  a  program  and  copying  pieces  from  other  existing  programs 
as  you  went  along.  Some  of  the  files  you  visited  may  have  been 
accidentally  modified  or  may  have  been  visited  on  a  write-protected 
disk. 

If  you  are  simply  using  an  old  program  as  temporary  source  material, 
you  will  not  want  to  destroy  the  original  program.  When  you  are 
finished  writing  the  new  program,  save  your  new  material  and  exit 
MEMACS  without  saving  the  modified  buffers  of  the  source 
program. 

Two  alternate  keyboard  commands  for  the  Quit  command  are 
AXAC  and  <ESC>AC. 
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The  Edit  Menu 


The  commands  in  the  Edit  menu  affect  the  editing  of  your  buffers  and 
their  associated  files. 

Kill-region  W 

Deletes  blocks  of  text  from  the  current  buffer  and  saves  it  in  a  kill 
buffer,  a  special  buffer  for  text  that  has  been  deleted  from  buffers  by 
using  Kill  commands.  (Text  can  be  pulled  back  into  the  document  by 
using  the  Yank  command,  described  below.) 

If  a  block  of  text  has  been  *  'marked' '  using  the  Set-mark  command 
(explained  below)  and  the  cursor  has  been  positioned  away  from  the 
mark,  the  area  between  those  two  points  is  considered  a  block  and 
can  be  deleted  by  selecting  Kill-region. 

You  can  also  use  Kill-region  to  copy  a  block  from  one  section  of  the 
buffer  to  another.  Simply  mark  the  block,  select  Kill-region,  then 
without  moving  the  cursor,  immediately  select  Yank.  The  block 
will  be  restored  to  its  original  position,  but  there  will  also  be  a  copy  of 
the  block  in  the  kill  buffer. 

If  you  repeatedly  select  Kill-region  on  different  areas  of  text,  without 
performing  a  Yank,  each  successive  kill  segment  is  appended  to  the 
kill  buffer.  When  you  perform  the  first  Yank,  it  marks  the  end  of  the 
kill  buffer. 


Yank 


Copies  the  contents  of  the  kill  buffer  to  the  line  immediately  above 
the  current  cursor  location  in  the  current  buffer.  Yank  reverses  the 
action  of  Kill-region,  but  it  does  not  change  the  contents  of  the  kill 
buffer.  Therefore,  you  can  repeatedly  move  the  cursor  to  another 
buffer,  select  Yank,  and  copy  the  contents  of  the  kill  buffer.  The  next 
time  you  kill  a  block  of  text,  however,  the  contents  of  the  kill  buffer 
will  be  replaced  with  the  new  material,  and  the  old  contents  will  be 
lost. 

Kill-region  and  Yank  are  often  used  together  to  move  text  from  one 
buffer  to  another. 

Set-mark  A  @ 

Marks  the  cursor  position  in  a  buffer.  When  you  select  Set-mark,  the 
position  of  the  cursor  is  marked  in  the  current  buffer.  From  then  on, 
any  other  position  of  the  cursor  is  referred  to  as  the  dot.  You  can 
move  back  and  forth  between  the  mark  and  the  dot  by  selecting  the 
Swap-dot&mark  command  in  the  Move  menu. 

You  can  use  Set-mark  to  mark  the  beginning  of  a  block  of  text  that 
you  want  to  duplicate  or  move  somewhere  else  in  the  buffer.  Set  the 
mark  on  the  first  character  you  want  to  include  in  the  block.  As  you 
move  the  cursor  through  the  file,  you  are  essentially  blocking  out  a 
portion  of  text. 

An  alternate  keyboard  shortcut  for  Set  Mark  is  <ESC>-. 
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Copy-region  <ESC>W 

Copies  the  contents  of  the  marked  region  to  the  kill  buffer.  This  new 
text  replaces  any  previous  contents  of  the  kill  buffer. 

Upper-region  AXAU 

Changes  the  text  of  the  entire  marked  region,  the  area  between  the 
mark  and  the  current  cursor  position  (dot),  to  upper  case. 

Lower-region  AXAL 

Changes  the  text  of  the  entire  marked  region  to  lower  case. 

List-buffers  TB 

Splits  the  current  buffers  window  and  provides  you  with  a  list  of  the 
buffers  that  MEMACS  is  currently  maintaining.  The  list  has  4  col- 
umns. For  example: 

C   Size   Buffer     File 

*   17260   emacs.doc  dfl:docfiles/emacs.doc 

C  is  an  abbreviation  of '  'Changed' '  and  will  display  an  asterisk  if  the 
buffer  has  been  modified  since  it  was  last  saved  to  a  file. 

Size  shows  how  many  characters  there  are  in  a  particular  buffer. 

Buffer  shows  the  name  given  to  this  particular  buffer.  If  you  have 
read  in  a  file,  this  will  usually  be  the  name  of  the  file  itself,  minus  the 
full  path.  For  example,  if  the  file  you  are  editing  is  dfl:docfiles/e- 
macs.doc,  then  its  buffer  name  will  be  emacs.doc. 

File  shows  the  name  of  the  file,  including  the  full  path.  This  shows 
you  where  MEMACS  will  write  this  file  if  you  choose  Save-file  or 
Save-exit  while  your  cursor  is  in  that  buffer. 

When  you  choose  List-buffers,  the  status  line  at  the  bottom  of  the 
screen  displays  "MEMACS  -  [List]".  Even  though  List-buffers 
brings  up  a  window  display,  it  is  not  listed  as  an  available  buffer.  If 
you  edit  the  List-buffers  window,  it  can  be  made  to  act  just  like  any 
other  buffer.  If,  for  example,  you  open  a  file  in  the  List-buffers 
window,  the  name  of  the  buffer  will  continue  to  be  [List],  and  the 
name  of  the  file  you  have  opened  will  become  associated  with  the 
List-buffers  window. 

If  you  should  leave  the  List-buffers  window  on  the  screen  but  use  a 
different  window  to  modify  the  listed  buffers,  the  List-buffers  display 
will  not  be  continuously  changed  to  reflect  the  current  changes.  To 
get  current  information,  you  must  select  List-buffers  again. 

Select-buffer  AXb 

Lets  you  select  which  buffer  you  wish  to  edit  in  the  currently 
selected  window,  the  window  where  your  cursor  is  positioned. 
When  you  choose  Select-buffer,  MEMACS  moves  the  cursor  to  the 
bottom  line  and  asks: 

Use  buffer: 
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You  must  provide  a  name  that  is  the  same  as  one  of  those  shown  in 
the  List-buffers  listing.  If  you  specify  one  of  the  available  names,  that 
buffer  replaces  the  contents  of  the  currently  selected  window. 

If  you  specify  a  name  that  is  not  in  the  List-buffers  listing,  you  are 
telling  MEMACS  to  create  a  new  buffer  with  that  name.  In  this  case, 
there  is  no  filename  associated  with  the  new  buffer  and  you  will  have 
to  rename  the  file  or  select  Save-as-file  when  you  are  prepared  to 
save  the  buffer's  contents  to  a  file. 

If  you  simply  press  <RETURN>,  the  command  is  ignored. 

Insert-buffer  <ESC>AY 

Inserts  the  contents  of  a  named  buffer  into  the  current  buffer  at  the 
line  above  the  current  cursor  position.  When  you  select  Insert-buffer, 
MEMACS  asks: 

Insert  buffer: 

You  must  type  the  name  of  the  buffer  to  insert,  then  press  <RE- 
TURN>. 

Kill-buffer  Xk 

Deletes  the  contents  of  a  chosen  buffer.  MEMACS  can  only  edit  a  file 
if  the  entire  file  will  fit  in  the  available  memory.  To  make  room  in  the 
system's  memory,  you  can  use  Kill-buffer  to  delete  the  contents  of 
one  or  more  buffers.  This  command  returns  the  buffer's  memory  to 
the  memory  manager  for  reuse. 

When  you  choose  Kill-buffer,  MEMACS  asks: 

Kill  buffer: 

You  must  then  enter  the  name  of  the  buffer  you  wish  to  delete.  You 
cannot  kill  a  buffer  if  its  contents  are  currently  displayed. 

Justify-buffer  XJ 

Removes  all  blank  spaces  and  tabs  from  the  left-hand  edge  of  all  the 
lines  in  the  current  buffer.  The  text  is  rearranged  so  that  it  aligns  with 
the  current  margins. 

Redisplay  AL 

Causes  a  complete  redrawing  of  the  entire  screen. 

Quote-char  AQ 

Lets  you  ' l  Quote  '  a  character  and  make  it  part  of  the  text  file.  Some 
keyboard  selections  have  been  assigned  as  MEMACS  control  char- 
acters (for  instance,  the  menu  command  shortcuts).  If  you  try  to 
insert  such  a  selection  into  your  text,  MEMACS  will  react  as  if  you 
chose  a  menu  item. 

For  example,  Control-L  (AL)  tells  MEMACS  to  redraw  the  display, 
but  AL  is  also  useful  as  a  printing  control  to  insert  a  formfeed 
character.  By  selecting  Quote-char,  the  next  character  you  type  will 
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be  taken  *  'literally' '  by  MEMACS  and  will  be  inserted  into  the  text 
file,  instead  of  being  treated  as  a  menu  command. 

To  designate  a  Control-key  combination,  use  the  caret  (A)  fol- 
lowed by  the  character,  as  used  in  this  manual.  As  MEMACS  manip- 
ulates the  buffer,  the  combination  of  the  caret  and  the  character  is 
treated  as  a  single  character,  both  by  the  cursor  keys  and  the 
character  counter. 

You  can  also  use  Quote-char  to  insert  a  <RETURN>  key  into  the 
text  or  to  insert  any  other  control  character  that  may  be  needed 
during  a  macro  command.  Even  AQ  can  be  inserted  by  typing  it 
twice. 

An  alternate  keyboard  shortcut  for  Quote  char  is  AXq. 

Indent  AJ 

Moves  the  cursor  to  the  next  line,  automatically  indenting  the  same 
amount  of  spaces  as  the  previous  line. 

Transpose  AT 

Swaps  the  positions  of  two  adjacent  characters.  Place  the  cursor  on 
the  rightmost  of  the  two  characters. 

Cancel  AG 

Ends  an  ongoing  menu  command,  such  as  a  query  search  and 
replace. 
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The  Window  Menu 

A  window  in  MEMACS  is  not  the  same  as  a  window  in  Intuition  (the 
Workbench's  display  system).  MEMACS  splits  the  screen  into  multiple 
slices,  allowing  you  to  edit  a  separate  file  (buffer)  in  each  MEMACS 
window.  The  Window  menu  lets  you  control  how  you  view  your  buffers 
on  the  screen. 

One-window  AX1 

Makes  the  current  buffer  a  single,  full-sized  window  on  the  MEMACS 
screen.  All  other  buffers  remain  invisible,  allowing  you  maximum 
space  to  work  on  the  current  buffer. 

Split-window  X2 

Splits  the  current  window  in  half,  positioning  the  current  buffer 
identically  in  both  windows.  This  lets  you  edit  two  segments  of  the 
buffer  at  the  same  time.  Any  changes  made  in  either  window  affect 
the  entire  buffer.  This  is  convenient  when  you  want  to  see  what  you 
wrote  in  an  earlier  part  of  your  document  while  working  on  a  later 
section. 

Next-window  AXn 

Moves  the  cursor  "down"  to  the  next  window  and  makes  that 
window  available  for  editing. 

Prev-window  AXp 

Moves  the  cursor '  'up* '  to  the  next  window  and  makes  that  window 
available  for  editing. 

The  Next-window  and  Prev-window  commands  wrap-around.  If 
you  move  the  cursor  down  as  far  as  it  will  go,  the  cursor  will 
automatically  move  up  to  the  top  window.  Selecting  Prev-window 
when  the  cursor  is  in  the  top  window  will  move  the  cursor  to  the 
bottom  window. 

Expand-window  AXz 

Adds  a  line  to  the  current  window  and  simultaneously  deletes  a  line 
from  the  adjacent  window. 

Shrink-window  AXAZ 

Deletes  a  line  from  the  current  window  and  simultaneously  adds  a 
line  to  the  adjacent  window. 

Next-w-page  <ESC>AV 

Displays  the  next  page  of  the  next  window.  For  instance,  if  you  have 
split  a  window  and  are  working  in  the  top  one,  selecting  Next-w- 
page  will  move  the  contents  of  the  bottom  window  (the  one  you 
aren't  working  in)  to  the  next  page.  This  doesn't  make  the  window 
available  for  editing;  it  just  lets  you  view  the  contents. 

Prev-w-page  AXv 

Displays  the  next  page  of  the  previous  window.  If  only  one  window 
is  displayed,  it  displays  the  next  page  of  that  window. 
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The  Move  Menu 


The  commands  in  the  Move  menu  let  you  move  the  cursor  rapidly 
through  the  current  buffer. 

Top-of-buffer  <ESC>  < 

Moves  the  cursor  to  the  top  line  of  the  current  buffer. 
End-of-buffer  <ESC» 

Moves  the  cursor  to  the  bottom  line  of  the  current  buffer. 
Top-of-window  <ESC>, 

Moves  the  cursor  to  the  top  of  the  current  window. 
End-of-window  <ESC>. 

Moves  the  cursor  to  the  bottom  of  the  current  window. 

Goto-line  TG 

Moves  the  cursor  to  a  specific  line  number.  When  you  select  Goto- 
line,  MEMACS  moves  the  cursor  to  the  bottom  of  the  screen  and 
asks: 

goto-line: 

Enter  a  line  number,  press  <RETURN>,  and  MEMACS  moves  the 
cursor  directly  to  that  line.  If  you  specify  a  line  number  larger  than 
the  total  number  of  lines  in  the  buffer,  MEMACS  moves  the  cursor  to 
the  last  line  of  the  buffer. 

Swap-dot&mark  AXAX 

Places  a  mark  at  the  current  cursor  position  and  moves  the  cursor  to 
where  the  mark  had  been  set.  If  you  have  not  yet  set  a  mark  in  the 
window,  MEMACS  replies,  "No  mark  in  this  window/'  This  com- 
mand lets  you  move  quickly  to  and  from  a  preset  location  in  your 
buffer.  Selecting  this  item  again,  restores  the  cursor  to  where  it  was 
before  you  selected  Swap-dot&mark  the  first  time. 

Next-page  AV 

Moves  the  text  within  the  window  toward  the  end  of  the  buffer  by 
one  full  window,  less  one  line.  The  cursor  is  repositioned  so  as  to 
stay  on  the  screen. 

Prev-page  <ESC>v 

Moves  the  text  within  the  window  toward  the  beginning  of  the  buffer 
by  one  full  window,  less  one  line.  The  cursor  is  repositioned  so  as  to 
stay  on  the  screen. 

Next-word  <ESC>f 

Moves  the  cursor  forward  to  the  next  non-alphanumeric  character 
after  the  current  word. 
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Previous-word  <ESC>b 

Moves  the  cursor  back  to  the  first  letter  of  the  previous  word. 

Scroll-up  AZ 

Moves  the  text  within  the  window  towards  the  end  of  the  buffer  by  a 
single  line. 

Scroll-down  <ESC>z 

Moves  the  text  within  the  window  towards  the  beginning  of  the 
buffer  by  a  single  line. 

The  Line  Menu 

The  commands  in  the  Line  menu  let  you  move  the  cursor  within  or 
between  lines  and  let  you  perform  operations  involving  entire  lines. 

Open-line  A0 

Splits  the  line  the  cursor  is  in,  forcing  the  character  on  which  the 
cursor  rests  to  become  the  first  character  of  the  following  line.  This 
command  leaves  the  cursor  in  the  original  line  so  that  you  can  type 
new  characters  beginning  at  the  current  cursor  position. 

If  you  select  Open-line  by  mistake,  immediately  pressing  the 
<DEL>  key  will  close  up  the  line. 

Kill-line  TD 

Deletes  the  line  in  which  the  cursor  is  located  and  places  the  text  in 
the  kill  buffer.  If  you  have  not  selected  Yank  since  the  last  Kill 
command,  the  text  will  be  appended  to  any  existing  text  in  the  kill 
buffer. 

Kill-to-eol  K 

Deletes  the  text  between  the  current  cursor  position  and  the  end  of 
the  line.  This  text  enters  the  kill  buffer  and  will  be  appended  to  the 
existing  text  if  a  Yank  has  not  been  recently  performed.  The  text  can 
also  be  restored  to  your  file  by  immediately  selecting  Yank. 

Start-of-line  A 

Moves  the  cursor  to  the  leftmost  position  on  a  line. 

End-of-line  E 

Moves  the  cursor  to  the  rightmost  position  on  a  line.  If  you  have 
typed  more  than  80  characters  on  a  line,  a  dollar  sign  ($)  appears  at 
the  right  edge  of  the  line.  Moving  to  the  end  of  the  line  places  the 
cursor  logically  on  the  rightmost  character  even  though  you  cannot 
see  it.  Physically  the  cursor  is  positioned  over  the  dollar  sign.  If  you 
use  the  left-arrow  cursor  key  to  move  the  cursor  to  the  left,  it  will  take 
as  many  key  presses  as  there  are  unseen  characters  before  the  cursor 
actually  begins  to  move. 
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Next-line  N 

Moves  the  cursor  down  one  line. 
Previous-line  AP 

Moves  the  cursor  up  one  line. 
Line-to-top  <ESC>! 

Moves  the  line  containing  the  cursor  to  the  top  of  the  window. 

Delete-blanks  aXaO 

Deletes  blank  lines,  proceeding  forward  from  the  current  cursor 
position,  until  MEMACS  gets  to  the  next  line  on  which  text  exists. 

Show-Line#  AX  = 

Displays  information  on  the  present  cursor  position.  For  example: 

Line  17  Column  1   (2%) 

In  this  example,  the  cursor  is  on  the  17th  line  of  text,  in  the  first 
column.  The  percentage  shows  that  the  cursor  is  in  a  position  2%  of 
the  way  from  the  top  of  the  buffer.  In  other  words,  if  the  cursor  was 
on  the  last  character  of  text,  the  percentage  would  be  equal  to  100. 

The  Word  Menu 

The  Word  menu  contains  word-associated  operations. 

delete-forw  <ESC>d 

Deletes  the  character  on  which  the  cursor  is  positioned  and  all 
remaining  characters  to  the  right  until  the  next  non-alphanumeric 
character  is  found,  (i.e.  a  blank  space,  tab,  or  punctuation  mark). 

For  instance,  if  the  cursor  is  positioned  on  the  "s"  in  the  word 
wordsuffix,  choosing  delete-forw  will  delete  "suffix"  from  the 
word.  If  the  cursor  is  positioned  on  a  blank  space,  it  must  be  moved 
forward  to  the  start  of  a  word  to  delete  that  word. 

delete-back  <ESC>h 

Deletes  the  character  on  which  the  cursor  is  sitting  and  all  remaining 
characters  to  the  left  of  the  cursor  until  it  finds  the  first  character  of  a 
word. 

An  alternate  form  of  this  command  is  <ESC><DEL>. 

Upper-word  <ESC>u 

Changes  a  word  to  upper  case,  starting  at  the  character  where  the 
cursor  is  positioned  and  proceeding  to  the  last  character  of  the  word. 

Lower-word  <ESC>1 

Changes  a  word  to  lower  case,  starting  at  the  character  where  the 
cursor  is  positioned  and  proceeding  to  the  last  character  of  the  word. 
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Cap-word  <ESC>c 

Changes  the  character  where  the  cursor  is  positioned  to  upper  case. 
It  also  changes  the  characters  to  the  right  of  the  cursor,  up  to  the  end 
of  the  word,  to  lower  case. 

Switch-case  <ESC>A 

Changes  the  case  of  a  word,  starting  at  the  current  cursor  position 
and  proceeding  to  the  right  until  it  reaches  the  end  of  the  word.  If  a 
word  is  upper  case  it  changes  it  to  lower  case,  and  vice  versa. 

The  Search  Menu 

The  Search  menu  allows  you  to  search  through  the  current  buffer  for 
specific  text  strings.  The  case  (upper  or  lower)  of  the  string  is  not  signifi- 
cant in  the  search  itself.  However,  if  you  are  using  text  substitution 
(search  and  replace),  the  text  will  be  replaced  in  the  same  case  as  that  of 
the  replacement  string. 

Search-forward  AS 

Searches  through  the  text  starting  at  the  current  cursor  position  and 
moving  forward  to  the  end  of  the  buffer.  When  you  issue  this 
command,  MEMACS  moves  the  cursor  to  the  bottom  line  of  the 
screen  and  asks: 

Search: 

Enter  the  string  of  characters  that  you  want  MEMACS  to  search  for, 
and  press  <RETURN>.  If  the  string  is  found,  MEMACS  positions 
the  cursor  immediately  following  the  last  character  of  the  string. 

If  MEMACS  cannot  find  the  string,  it  replies  '  'Not  found.' ' 

An  alternate  form  of  this  command  is  AXs. 

Search-backward  AR 

Searches  through  the  text  from  the  current  cursor  position  back- 
wards to  the  beginning  of  the  buffer.  This  command  operates  in  the 
same  manner  as  Search-forward.  An  alternate  form  of  this  command 
isAXr. 

Search-replace  <ESC>r 

Operates  the  same  way  as  Search-forward,  except  that  it  allows  you 
to  replace  the  string  with  different  text.  When  MEMACS  finds  the 
first  occurrence  of  a  specified  string,  it  asks: 

Replace: 

You  must  enter  the  string  of  characters  that  should  replace  the  found 
string.  Remember,  the  characters  will  appear  in  the  same  case  as  you 
type  them.  When  you  press  <RETURN>,  MEMACS  will  automati- 
cally forward-search  the  rest  of  the  file  and  replace  the  search-string 
with  the  replacement-string.  After  MEMACS  completes  this  com- 
mand, it  reports: 

Replaced  (xx)  occurrences 

(xx)  stands  for  the  number  of  times  the  string  was  replaced. 
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Query-s-r  <ESC>q 

Operates  the  same  way  as  Search-replace,  except  that  it  allows  you 
to  choose  whether  or  not  to  replace  each  occurrence  of  the  string. 
When  you  select  Query-s-r,  MEMACS  prompts: 

Query  replace: 

As  it  finds  a  matching  string,  it  always  asks: 

Change  string?  [y/n/c/AG]? 

The  options  are:  y  (yes);  n  (no);  c  (changes  all  occurrences  of  the 
string);  and  AG  (abort).  This  gives  you  a  chance  to  control  the 
replacement  process.  After  MEMACS  completes  this  command,  it 
reports: 

Replaced  (xx)  occurrences 

Fence-match  <ESC>AF 

Finds  the  next  occurrence  of  a  character  that  is  the  same  as  the  one 
at  the  current  cursor  position.  For  instance,  if  the  cursor  is  resting  on 
an  asterisk  (*),  choosing  Fence-match  will  move  the  cursor  to  the 
next  occurrence  of  an  asterisk  in  the  text 

The  Extras  Menu 

The  Extras  menu  contains  commands  to  let  you  tell  MEMACS  how  to 
operate.  Many  of  these  operational  commands  require  that  you  specify  a 
numeric  argument  before  selecting  the  command  itself.  This  menu  also 
includes  several  macro  commands.  A  macro  command  is  actually  a 
sequence  of  commands  or  other  keystrokes  that  are  executed  by  select- 
ing the  menu  item  Execute-macro. 

Set-arg  AU 

Lets  you  specify  a  numeric  argument  for  the  operational  commands. 
When  you  issue  this  command,  MEMACS  responds  by  moving  to 
the  bottom  line  and  prompting: 

Arg:   4_ 

If  you  select  Set-arg  again,  MEMACS  multiplies  the  argument  value 
by  4. 

If  you  press  a  numeric  key  (0-9),  MEMACS  accepts  an  integer 
argument.  If  you  press  a  minus  sign  first,  MEMACS  accepts  a  nega- 
tive integer  argument,  starting  at  -1. 

Examples:  (Each  started  by  a  single  press  of  AU) 

Arg:  -1  (pressed  ' '-' '  as  the  first  key) 

Arg:  -23        (pressed  * '-  2  3"  as  a  3-key  sequence) 

Arg:  12  (pressed  '  '3  AU' '  as  a  2-key  sequence) 

MEMACS  accepts  the  argument  value  as  a  key  for  whatever  you  do 
next  To  add  12  blank  lines  at  the  cursor  position,  specify  an  argu- 
ment of  12,  then  press  <RETURN>.  To  add  20  minus  signs,  select 
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an  argument  number  of  20,  do  not  press  <RETURN>,  and  press 
the  minus  sign  on  the  keyboard.  (Note:  Don't  use  the  keypad's 
minus  sign;  it  is  mapped  to  a  different  value.) 

To  set  one  of  the  MEMACS  operational  parameters  (described 
below),  select  the  value  of  the  argument,  do  not  press  <RE- 
TURN>,  then  select  the  appropriate  menu  item.  MEMACS  will  use 
the  argument  to  set  the  value. 

Set  <ESC>s 

Allows  you  to  choose  various  MEMACS  parameters.  When  you 
choose  Set,  MEMACS  prompts: 

Set: 

You  can  then  enter  one  of  the  following: 

Screen  places  the  MEMACS  display  in  a  Workbench  window  or 
back  onto  a  custom  screen 

Interlace    turns  the  interlace  mode  on  or  off 

Mode        results  in  a  second  prompt  "Mode:";  you  can  enter 

cmode  (for  editing  c  programs)  or  wrap*  (to  enable 
automatic  wordwrap  when  the  text  reaches  a  set  cursor 
position).  Cmode  provides  automatic  fence  matching. 
Use  +  mode  or  -  mode  to  add  or  subtract  a  mode. 

Left*         determines  the  left  margin 

Right*       determines  the  right  margin 

Tab*         sets  the  increment  for  tab  spacing 

Indent*  used  in  cmode  to  determine  how  far  to  indent  each  level 
of  nesting 

Case         turns  case  sensitive  searches  on  or  off;  default  is  off 

Backup  turns  on  or  off  MEMACS'  backup  function.  Your  options 
are  ON  (renames  the  current  file  <filename>.bak  and 
saves  that  backup  file  to  the  T:  directory),  SAFE  (this 
option  checks  to  see  if  a  file  already  exists  for  the  buffer;  if 
so,  it  will  not  overwrite  the  existing  file),  and  OFF  (this  is 
the  default  option;  MEMACS  does  not  perform  any 
backup) 

*Each  of  these  entries  results  in  a  prompt  for  a  numerical  argument,  unless  the  numeric 
argument  is  given  along  with  the  entry. 

Start-macro  *X( 

Tells  MEMACS  to  start  recording  any  subsequent  keystrokes  or 
menu  selections.  This  is  a  macro  command  and  is  used  in  conjunc- 
tion with  the  Stop-macro  and  Execute-macro  commands. 

Stop-macro  AX) 

Tells  MEMACS  to  stop  recording  keystrokes. 
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Execute-macro  AXe 

Repeats  keystrokes  and  menu  selections  that  were  entered  between 
Start-macro  and  Stop-macro.  They  are  repeated  as  if  you  had 
freshly  entered  the  entire  sequence. 

Set-key  TK 

Allows  you  to  redefine  all  of  the  function  keys,  the  Shifted  function 
keys,  the  Help  key,  or  any  key  on  the  numeric  keypad  as  keyboard 
macros.  This  means  that  if  you  select  one  of  these  redefined  keys 
while  recording  macro  commands,  the  new  key  definition  will  be 
recorded  in  the  command.  One  definition,  having  as  many  as  80 
keystrokes,  can  be  recorded  for  each  of  these  keys. 

NOTE:  If  you  want  to  insert  the  Set-mark  command  into  any  of  the 
keyboard  macro  definitions,  you  can't  use  the  menu  shortcut  of 
A@.  This  does  not  function  correctly  when  used  in  a  macro 
command.  Instead,  you  must  use  the  alternate  form  of  Set-mark, 
<ESC>-.  This  alternate  form  is  acceptable  in  macro  commands. 

When  you  choose  Set-key,  MEMACS  asks: 

key  to  define: 

Press  one  of  the  10  function  keys,  the  Help  key,  or  a  numeric 
keypad  key.  MEMACS  responds: 

def :  [commands] : 

[commands]  is  a  display  of  the  current  commands  bound  to  that  key. 
Enter  the  new  string  of  characters  (up  to  80)  that  you  want  to  have 
MEMACS  respond  to  when  this  key  is  pressed.  Pressing  <RE- 
TURN>  terminates  the  entry. 

Remember  that  when  entering  commands  that  involve  function 
keys,  for  example  <ESC><  (go  to  top  of  buffer),  you  must  use 
Quote  character  [AQ]  to  properly  insert  the  function  key  keystroke 
into  the  definition. 

The  chart  below  contains  the  default  values  of  the  function  keys 
when  used  in  macro  commands: 


KEY 

DEFAULT  VALUE 

KEY  SEQUENCE 

fkeyl 

clone  line 

AAAKAYAMAY 

fkey2 

delete  line 

AXAD 

fkey3 

execute  keyboard  macro 

AXe 

fkey4 

next  screen 

AV 

fkey5 

previous  screen 

<ESC>v 

fkey  6 

split  window 

AX2 

fkey7 

one  window 

AX1 

fkey  8 

scroll  window  up 

AZ 

fkey  9 

scroll  window  down 

<ESOZ 

fkey  10 

save  file  and  exit 

AXAF 

help 

insert  line  and  indent 

AJ 

keypad  enter 

insert  line  and  indent 

AJ 
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The  numeric,  period,  and  minus  keys  on  the  numeric  keypad  default 
to  their  normal  values  (i.e.  keypad  1  defaults  to  1,  keypad  2  defaults 
to  2,  etc.). 

Reset-keys  <ESC>k 

Returns  any  keys  defined  by  Set-keys  to  their  original  default  state. 

Execute-file  <ESC>e 

Allows  you  to  execute  a  program  file  within  MEMACS.  When  you 
select  this  command,  MEMACS  prompts: 

File: 

Enter  the  name  of  the  file  you  wish  to  access.  This  file  is  executed  as 
a  file  of  MEMACS  commands. 

Execute-line  A[A[ 

Sets  MEMACS  to  the  command  mode.  When  you  choose  Execute- 
line,  MEMACS  asks: 

execute-line: 

You  can  then  enter  any  menu  command  and  its  parameters  by 
simply  typing  it  at  the  prompt.  You  must  use  the  exact  format  used  in 
the  menus,  including  hyphens,  or  you  will  receive  an  alert  and 
*  'command  error' '  message.  For  instance,  you  can't  type: 

execute-line:  insert  file  <filename> 
You  must  type: 

execute-line:  insert-file  <filename> 
An  alternate  shortcut  for  execute-line  is  <ESC><ESC>. 

Commands  Not  Installed  in  Menus 

The  following  commands  have  not  been  installed  in  menus  and  are  only 
accessible  through  the  keyboard. 

Describe  Key  <ESOD 

Tells  you  if  any  functions  are  bound  to  a  key  or  key-sequence.  When 
you  select  <ESC>AD,  MEMACS  prompts  for  the  key  to  describe. 
If  you  enter  a  key  sequence,  such  as  AL  or  <ESC>k,  MEMACS 
will  respond  with  the  corresponding  function.  In  this  case,  Redisplay 
and  Reset-keys,  respectively. 

BindKey  <ESOB 

Allows  you  to  bind  a  key  to  a  function.  When  MEMACS  prompts  for 
the  key  to  bind,  enter  the  function  (following  the  format  used  in  the 
menu  items)  then  the  key  or  key  sequence.  To  check  if  the  key  was 
bound  properly,  use  Describe  key  (<ESC>AD). 
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Unbind  Key  <ESOAU 

Allows  you  to  return  a  bound  key  to  an  unbound  state.  When 
MEMACS  prompts  for  the  key  to  unbind,  enter  the  key  or  key 
sequence.  MEMACS  will  then  reply  '  'Key  is  not  bound." 

Echo  <ESC>AE 

Displays  the  string  typed  in  the  command  line.  This  command  is 
usually  used  when  creating  or  editing  executable  MEMACS  script 
files. 

Move  to  Edge  of  Window  <SHIFT>  +  Cursor  Key 

By  holding  down  the  Shift  key  and  a  cursor  arrow  key,  MEMACS 
will  move  to  the  top,  bottom,  left,  or  right  edge  of  the  screen.  This  is 
subject  to  the  amount  of  text  available. 

Delete  the  Next  Character  D 

Deletes  the  character  at  the  current  cursor  position.  This  is  the  same 
as  hitting  the  <DELETE>  key. 

Delete  the  Previous  Character  AH 

Deletes  the  character  to  the  left  of  the  current  cursor  position.  This  is 
the  same  as  hitting  the  <BACKSPACE>  key. 

Move  to  Next  Line  AM 

Inserts  a  newline  character  after  the  current  cursor  position  and 
moves  the  cursor  to  the  start  of  the  new  line. 

Move  Cursor  by  x  number  of  Characters  (forward)  AF 

(backward)         AB 

Allows  you  to  move  the  cursor  forward  or  backward  a  specified 
number  of  spaces.  The  default  value  of  this  command  is  one  charac- 
ter. However,  you  can  establish  a  higher  value  by  using  AU  to  set 
the  argument  value.  Then  select  AF  or  AB  to  move  that  number 
of  characters. 

Adding  MEMACS  Startup  Commands 

When  MEMACS  is  opened,  it  reads  the  contents  of  a  file  called  emacs_ 
pro  to  see  if  there  are  any  commands  that  it  should  automatically  execute. 

Emacs pro  does  not  exist;  you  have  to  create  it.  MEMACS  first  looks  in 

the  current  directory  for  emacs pro.  If  it  is  not  there,  it  looks  in  the  disk's 

s:  emacs  directory. 

You  can  create  more  than  one  emacs pro  file  if  you  wish.  You  can 

create  a  global  file  that  would  execute  a  series  of  commands  each  time 
MEMACS  is  opened.  And,  you  can  create  more  specified  local  files  with 
startup  commands  particular  to  a  certain  file  that  you  may  use  frequently. 
In  the  case  of  both  local  and  global  emacs__pro  files,  the  local  startup 
command  files  override  the  global  file. 
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Functional  Summary  of  Commands 

Operations: 

Replace  buffer  with  new  file  (Read-file)  AXAR 

Open  an  additional  file  (Visit-file)  AXAV 

Insert  a  file  into  current  buffer  (Insert-file)  AXAI 

Rename  the  buffer AXF 

Display  a  list  of  buffers AXAB 

Select  a  buffer  to  edit AXb 

Insert  contents  of  buffer  into  current  buffer <ESC>AY 

Write  buffer  to  new  file  (Save-as-file) AXAW 

Save  buffer  to  existing  buffer AXAS 

Save  all  modified  buffers AXAM 

Save  all  modified  buffers  and  exit AXAF 

Set  numeric  argument  value AU 

SetMEMACS parameters  <ESOs 

Show  the  current  cursor  position  (Show-line#) AX  = 

Run  one  CLI  command  AX! 

Open  a  CLI  window  A- 

Cancel  a  menu  command AG 

QuitMEMACS  AC 

AXAC 
<ESOAC 

Moving  Cursor: 

Swap  dot  and  mark  AXAX 

Move  forward  x  number  of  characters  AF* 

Move  backward  x  number  of  characters   AB* 

Move  to  start  of  line AA 

Move  to  end  of  line AE 

Go  to  a  specified  line AXAG 

Move  to  next  line AN 

Move  to  previous  line AP 

Move  to  next  page AV 

Move  to  previous  page   <ESC>v 

Move  to  start  of  buffer  <ESC>< 

Move  to  end  of  buffer <ESC>> 

Move  to  next  word <ESC>f 

Move  to  previous  word <ESC>b 

*Used  in  conjunction  with  Set-arg  (AU) 
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Windows: 

Make  current  buffer  a  full-sized  window  (One-Window)  AX1 

Split  current  window  AX2 

Expand  window   AXz 

Shrink  window   AXAZ 

Move  cursor  to  top  of  window <ESC>, 

Move  cursor  to  end  of  window  <ESC>. 

Move  current  line  to  top  of  window   <ESC>! 

Scroll  window  up  one  line  AZ 

Scroll  window  down  one  line   <ESC>z 

Move  cursor  to  next  window AXn 

Move  cursor  to  previous  window AXp 

Redraw  the  screen  AL 

Text: 

Set  a  mark  in  the  text A@ 

<ESC>- 

Quote  a  character AQ 

AXq 

Justify  text  in  buffer   AXJ 

Transpose  characters  AT 

Make  a  word  upper  case <ESC>u 

Make  a  word  lower  case <ESC>1 

Make  a  region  upper  case AXAU 

Make  a  region  lower  case AXAL 

Change  the  case  of  a  word  <ESC>A 

Capitalize  a  word's  first  letter <ESC>c 

Insert  a  tab  AI 

<TAB> 

Insert  line,  cursor  is  moved  to  next  line AM 

<RETURN> 
Insert  line,  cursor  is  moved  to  next  line  and  indented  same  number  of 

spaces  as  previous  line  AJ 

Split  the  line  (Open-line)   A0 
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Delete  and  Copy: 

Delete  next  character AD 

<DEL> 
Delete  previous  character  AH 

<BACKSPACE> 

Delete  next  word <ESC>d 

Delete  previous  word <ESC>h 

<ESO<DEL> 

Delete  text  from  cursor  to  end  of  line AK 

Delete  entire  line AXAD 

Delete  region  between  dot  and  mark   AW 

Delete  blank  lines AXA0 

Delete  entire  buffer AXk 

Copy  contents  of  marked  region  into  kill  buffer <ESC>w 

Copy  contents  of  kill  buffer  into  current  buffer  (YANK)   AY 

Search: 

Search  forward AS 

AXs 

Search  backward  AR 

AXr 

Search  forward  and  replace <ESC>r 

Search  forward,  query  and  replace  <ESC>q 

Fence  match  <ESC>AF 

Macro  Commands: 

Start  macro  commands AX( 

Stop  macro  commands AX) 

Execute  macro  commands   AXe 

<ESC>~ 

Execute  line T[ 

<ESC><ESC> 

Execute  file <ESC>e 

Define  function  keys  (Set-key)   AXAK 

Reset  keys <ESC>k 

Describe  key <ESC>AD 

Bind  key  <ESOAB 

Unbind  key <ESOAU 

Echo  string   <ESC>AE 
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Alphabetical  Summary  of  Commands 

Remember:  When  a  key  is  shown  enclosed  in  apostrophes  it  means  that 
the  case  of  the  key  does  not  matter;  it  is  the  keycap  itself  which  controls 
the  function. 

Control-Key  Combinations 

Set-mark   A'@' 

New-CLI ";' 

Execute-line Tl 

Start-of-line A'A| 

Move  backward  x  number  of  characters  A'B'* 

QuitMEMACS A'C 

Delete  next  character A,D' 

Move  to  end  of  line   A'E' 

Move  forward  x  number  of  characters  A,F* 

Cancel  a  menu  command A'G' 

Delete  previous  character A'H' 

Insert  a  tab  AT 

Insert  line,  cursor  is  moved  to  next  line  and  indented  same  number  of 

spaces  as  previous  line  A'J' 

Kill-to-eol "K 

Redisplay A'L' 

Insert  line,  cursor  is  moved  to  next  line A,M' 

Next-line AW 

Open-line  A'0' 

Previous-line A,F 

Quote  a  character   A'Q' 

Search-backward A'R' 

Search-forward A'S' 

Transpose  A'T 

Set  argument  value  A'U' 

Next-page A'V 

Kill-region A'W 

Yank   A V 

Scroll  window  up   A'Z' 

*Used  in  conjunction  with  Set-arg  (AU) 
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Control-X/Control-Key  Combinations 

List-buffers AXAB 

QuitMEMACS  AXAC 

Kill-line AXAD 

Save-exit  AXAF 

Goto-line AXAG 

Insert-file AXAI 

Define  function  keys  (Set-key)   AXAK 

Make  a  region  lower  case AXAL 

Save  all  modified  buffers AXAM 

Delete-blanks  AXA0 

Read-file   AXAR 

Save-file AXAS 

Make  a  region  upper  case AXAU 

Visit-file  AXAV 

Save-as-file AXAW 

Swap-dot&mark AXAX 

Shrink-window   AXAZ 

Control-X/Key  Combinations 

CLI-Command   AX! 

Start  macro  commands AX( 

Stop  macro  commands AX) 

Show-Line#  AX  = 

One-window AX1 

Split-window AX2 

Select-buffer AX'b' 

Execute-macro AX'e' 

Rename  buffer AX'F 

Justify  text AX' J' 

Kill-buffer AX'k' 

Next-window   AX'n' 

Previous-window AX'p' 

Quote  character AX'q' 

Search-backward   AXY 

Search-forward AXV 

Next  page  of  previous  window AXV 

Expand-window  AX'z' 
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Escape-Key  Combinations 

Line-to-top  of  window  <ESC>! 

Switch-case  <ESC>A 

Set  mark   <ESC>- 

Move  to  top  of  window   <ESC>, 

Move  to  end  of  window <ESC>. 

Top-of-buffer <ESC>< 

End-of-buffer <ESC» 

Bind  key  <ESC>AB 

Previous-word  <ESC>b 

QuitMEMACS <ESOAC 

Capitalize  a  word  <ESC>c 

Describe  key <ESC>AD 

Delete  next  word <ESC>d 

Echo <ESC>AE 

Execute-file <ESC>e 

Fence-match <ESC>AF 

Next-word  <ESC>f 

Delete  previous  word <ESC>h 

Reset-keys <ESC>k 

Make  a  word  lower  case <ESC>1 

Query,  search  and  replace   <ESC>q 

Search-replace   <ESC>r 

Set  <ESOs 

Unbind  key <ESC>AU 

Make  a  word  upper  case <ESC>u 

Next  page  of  next  window <ESC>AV 

Previous-page <ESC>v 

Copy-region <ESC>w 

Insert-buffer   <ESC>AY 

Scroll  window  down  one  line   <ESC>z 

Execute-line  <ESC><ESC> 

Delete  previous  word <ESC><DEL> 

Function  Keys 

Delete  next  character <DEL> 

Delete  previous  character  <BACKSPACE> 

Insert  line,  cursor  is  moved  to  next  line <RETURN> 

Insert  a  tab  <TAB> 
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A.  FOR  AMIGA  2000  OWNERS  WITH  HARD  DISKS  . . . 

If  you  own  an  Amiga  2000  and  have,  or  are  planning  to  have,  a  hard  disk 
installed,  there  are  some  aspects  of  Version  1.3  that  pertain  especially  to 
you.  First,  if  you  have  an  A2090A  Hard  Disk/SCSI  Controller,  you  can 
autoboot  directly  from  your  hard  disk.  Secondly,  there  is  a  new  FastFile- 
System,  FFS,  which  increases  the  speed  at  which  you  can  access  and  use 
your  hard  disk  files. 

The  A2090A 

The  A2090A  is  the  new  Hard  Disk/SCSI  Controller  card  for  the  Amiga 
2000.  Once  the  Version  1.3  Kickstart  ROM  is  in  place  in  your  A2000,  you 
can  automatically  boot  from  your  hard  disk.  There  is  no  need  to  insert  a 
Workbench,  or  other  bootable  application,  disk  into  your  floppy  disk 
drive!  The  A2090A  is  autobooting  because  of  the  interaction  between  the 
1.3  Kickstart  ROM  and  the  two  Autoboot  ROMs  on  the  A2090A.  (Your 
A2090A  may  not  have  these  ROMs  installed.  However,  complete  instal- 
lation instructions  are  included  with  the  A2090A  board.) 

The  FastFileSystem 

The  FastFileSystem  (FFS)  is  a  new  file  system  provided  for  use  with  any 
hard  disk  that  you  can  connect  to  your  Amiga.  The  only  restriction  is  that 
the  hard  disk  driver  must  provide  the  standard  set  of  disk  device  com- 
mands and  present  the  media  in  track  and  sector  format.  Since  Commo- 
dore's Hard  Disk/SCSI  Controller  auto-mounts  the  default  file  system  on 
the  first  partition  of  a  hard  disk,  it  is  not  possible  to  use  the  FastFileSystem 
there.  However,  using  the  new  1.3  Version  of  the  MOUNT  command,  it 
is  possible  to  make  additional  partitions  that  will  use  the  FastFileSystem. 

Since  most  hard  drives  use  DMA  (direct  memory  access)  to  transfer  data 
from  the  disk  to  memory,  the  old  file  system  is  inefficient  since  it  does  not 
use  the  hardware  to  its  full  potential.  FFS  addresses  this  problem  by 
storing  nothing  but  data  in  the  data  blocks.  Wherever  possible,  data 
blocks  are  allocated  consecutively;  this  means  that  large  reads  and  writes 
can  be  performed  in  one  operation.  A  pleasant  side  effect  of  the  new  data 
format  is  a  4.9%  increase  in  the  amount  of  data  that  can  be  stored  on  a 
given  disk.  This  amounts  to  about  an  extra  50K  per  Megabyte. 

The  speed  increases  are  a  little  difficult  to  quantify.  FFS  can  read  unfrag- 
mented  files  as  fast  as  the  disk  can  transfer  the  data,  and  it  can  write  files 
at  about  75%  of  the  maximum  disk  transfer  rate.  Validation  of  a  regular 
sized  hard  disk  (about  20  MB)  can  be  completed  about  40  times  faster 
with  FFS.  As  the  disk  transfer  speed  increases,  FFS  keeps  up  and  fully 
utilizes  the  data  bandwidth  of  a  given  controller.  Compatibility  with  most 
existing  software  has  been  maintained,  with  the  exception  of  some  Disk- 
Doctor  type  programs  that  only  have  knowledge  of  the  old  data  block 
format.  The  DiskDoctor  program  supplied  on  the  Version  1.3  Workbench 
disk  understands  the  normal  file  system  and  the  FastFileSystem. 
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Mounting  FFS 

The  A2090  driver  software  auto-mounts  the  first  hard  disk  partition  as  a 
normal  file  system  device.  The  FastFileSystem  may  be  used  on  any 
additional  partitions.  Since  the  partitions  are  mounted  using  the  MOUNT 
command,  a  different  file  system  may  be  specified  in  the  MountList 
entries.  However,  these  partitions  must  be  (re)formatted  in  FFS  format 
for  use  with  FFS. 

1.  First,  back  up  or  save  off  the  contents  of  your  hard  drive. 

2.  Boot  with  Version  1.3  Workbench  or  copy  the  new  1: FastFileSystem, 
c:  Mount,  and  c:  Format  files  to  your  boot  disk. 

3a.  IF  YOUR  HARD  DRIVE  IS  ALREADY  SUITABLY 
PARTITIONED . . . 

If  your  drive  is  currently  partitioned  and  the  first  partition  size  is 
acceptable  to  you  as  your  normal  file  system  partition,  you  will 
probably  be  able  to  avoid  re-prepping  and  re-formatting  your  entire 
drive.  (The  first  partition  should  usually  be  relatively  small.)  If  this  is 
the  case,  you  simply  need  to  add  three  lines  to  your  DEVS/Mount- 
List  entries  for  each  additional  Amiga  partition(s): 

GlobVec  =1 

FileSystem       =L: FastFileSystem 

DosType         =  0x444F530 1 

(WARNING:  Do  not  change  the  LowCyl  or  HighCyl  for  any  parti- 
tion! If  you  change  them,  you  must  re-prep  and  reformat  the  whole 
drive  —  see  3b.  If  you  change  the  names  of  your  partitions,  remem- 
ber to  also  change  the  names  being  mounted  in  your  startup- 
sequence  to  match. ) 

Now,  reboot  your  computer.  When  your  startup  script  mounts  these 
partitions  you  will  get '  'Not  A  DOS  Disk' '  requesters.  Cancel  them, 
then  format  the  FFS  partitions  with  the  new  FORMAT  command. 
For  example,  if  your  partition  is  named  fsl: 

FORMAT  DRIVE  fsl:    NAME  "FASTI"  FFS 

WARNING:  ALL  DATA  ON  THAT  PARTITION  WILL  BE 
LOST!  BE  SURE  TO  HAVE  A  BACK  UP  OF  YOUR  FILES. 

3b.  IF  YOUR  DRIVE  IS  NOT  SUITABLY  PARTITIONED  . .  . 

If  your  hard  drive  is  not  suitably  partitioned,  you  will  have  to  re-prep 
your  drive  and  reformat  all  partitions.  Edit  your  MountList  and  set  up 
entries  for  one  or  more  FFS  partitions.  Your  LowCyl  and  HighCyl 
entries  will  be  dependent  on  how  many  cylinders  you  plan  to  specify 
for  the  initial  auto-mount,  normal  file  system  partition  during  PREP. 

Some  people  prefer  a  small  initial  partition  (cylinders  2  through  3); 
others  like  a  first  partition  of  at  least  880K  to  hold  the  Workbench. 
The  following  equations  will  help  you  determine  how  many  cylinders 
will  hold  Workbench: 
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BytesPerCyl  =  BlocksPerTrack  x  Surfaces 

x512 

BytesPerFloppy  =  880  x  1024  =  901120 

CylsToHoldFloppy        =  BytesPerFloppy  / 
BytesPerCyl 
(round  up  the  result) 

For  example,  with  many  20MB  ST506  drives,  this  works  out  to  26 
cylinders. 

Use  PREP  as  described  in  your  A2090  manual  and  set  up  your 
partitions. 

Our  example  drive  would  be  prepped  for  cylinders*  0-1  reserved 
(RES0:),  cylinders  2-28  as  first  partition  (auto-mounted  normal  file 
system  DH0:),  and  the  remaining  cylinders  29-611  for  your  FastFile- 
System  partition. 

Once  PREP  is  complete,  reboot  the  machine,  then  proceed  through 
the  following  steps.  The  examples  here  assume  that  you  are  using  an 
ST506  20  Megabyte  drive  with  the  first  partition  occupying  cylinders 
2  to  28.  Note:  if  you  are  using  a  different  kind  of  drive  you 
will  have  to  adjust  the  drive  parameters. 

1.  Edit  your  DEVS/MountList  file,  and  add  an  entry  to  describe  your 
FFS  partition.  The  GlobVec,  FileSystem,  and  DosType  lines  are 
required  for  any  FFS  entry.  For  example: 

FS1:  Device  =  hddisk. device 
Unit  =  1 
Flags  =  0 
Surfaces  =  4 
BlocksPerTrack  =  17 
Reserved  =  2 
Interleave  =  0 
LowCyl  =  29 
HighCyl  =  611 
Buffers  =  20 
Stacksize  =  4000 
GlobVec  =  1 

FileSystem  =  L:FastFileSystem 
DosType  =  0x444F5301 

2.  Format  your  first  partition  (dhO:)  for  the  normal  file  system: 

FORMAT  DRIVE  DHO:  NAME  AmigaHD 

3.  Mount  your  FFS  partition: 

MOUNT  FS1: 

4.  Format  your  FFS  partition  for  the  FastFileSystem: 

FORMAT  DRIVE  FS1:    NAME  "FASTI"  FFS 
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The  FFS  option  marks  the  disk  as  being  used  with  the  FastFileSys- 
tem.  If  no  keyword  is  used,  FORMAT  will  check  the  DosType  entry 
in  the  MountList  to  see  if  an  alternate  file  system  is  specified.  If  the 
FastFileSystem  is  specified,  the  FFS  option  is  automatically  used. 
You  can  use  the  FFS  and  NOFFS  options  to  override  that  process. 

5.  Edit  your  startup-sequence  and  add  a  line,  somewhere  after 
BINDDRIVERS,  to  MOUNT  FS1:. 

Using  the  Recoverable  Ramdrive  with  FFS 

You  can  use  the  Recoverable  ramdrive  with  the  FastFileSystem,  but  you 
cannot  reboot  from  it.  If  you  are  going  to  use  the  Recoverable  ramdrive 
with  the  FFS,  you  must  change  the  BootPri  entry  in  the  ramdrive.  device 
MountList  (RAD:)  to  -129.  This  indicates  that  the  ramdrive. device  is  not 
bootable. 
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B.  REFERENCE  LIST  OF  DIRECTORIES/FILES  ON 
WORKBENCH 

C  Directory 


ADDBUFFERS 

Commands  the  file  system  to  add  cache  buffers. 

ASK 

Asks  for  user  input  when  executing  a  script  file. 

ASSIGN 

Assigns  a  logical  device  name  to  a  directory. 

AVAIL 

Reports  the  amount  of  CHIP  and  FAST  RAM  available. 

BINDDRIVERS 

Binds  device  drivers  to  hardware. 

BREAK 

Sets  attention  flags  in  the  specified  process. 

CD 

Sets,  changes  or  lists  the  current  directory. 

CHANGETASKPRI 

Changes  the  priority  of  processes  started  from  the  CLI. 

COPY 

Copies  a  file  or  directory. 

DATE 

Displays  or  sets  the  system  date  and/or  time. 

DELETE 

Deletes  up  to  10  files  or  directories. 

DIR 

Displays  a  sorted  list  of  the  contents  of  a  directory. 

DISKCHANGE 

Informs  the  Amiga  of  the  changing  of  a  disk  in  a  5V4"  drive. 

DISKDOCTOR 

Attempts  to  repair  a  corrupt  floppy  disk. 

ECHO 

Prints  a  string. 

ED 

Edits  text  files  (a  screen  editor). 

EDIT 

Edits  text  files  by  processing  the  source  file  sequentially. 

ELSE 

Allows  an  alternative  in  a  conditional  in  a  script  file. 

ENDCLI 

Ends  an  interactive  CLI  or  SHELL  process. 

ENDIF 

Terminates  an  IF  block  in  a  script  file. 

ENDSKIP 

Terminates  a  SKIP  block  in  a  script  file. 

EVAL 

Provides  a  means  of  evaluating  simple  expressions. 

EXECUTE 

Executes  a  command  file  with  argument  substitution. 

FAILAT 

Sets  the  failure  condition  of  a  script  file. 

FAULT 

Prints  the  specified  error  message(s). 

FF 

Speeds  up  the  display  of  text. 

FILENOTE 

Attaches  a  comment  to  a  file. 

GETENV 

Gets  the  value  of  an  environment  variable. 

ICONX 

Executes  an  AmigaDOS  script  file  from  the  Workbench. 

IF 

Handles  conditional  operations  in  script  files. 

INFO 

Gives  information  about  the  file  system. 
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INSTALL 

Handles  the  boot  block  of  a  formatted  disk. 

JOIN 

Links  together  up  to  15  files  to  make  a  new  file. 

LAB 

Specifies  a  label  in  a  script  file. 

LIST 

Lists  specified  information  about  directories  and  files. 

LOADWB 

Starts  Workbench. 

LOCK 

Sets  the  write-protect  status  of  a  hard  disk  using  FFS. 

MAKEDIR 

Creates  a  new  directory. 

MOUNT 

Creates  an  AmigaDOS  device  node. 

NEWCLI 

Starts  a  new  interactive  CLI  with  a  new  window. 

NEWSHELL 

Starts  a  new  interactive  SHELL  with  a  NEWCON:  window. 

PATH 

Controls  the  path  that  the  CLI  uses  to  search  for  commands. 

PROMPT 

Changes  the  prompt  string  of  the  current  SHELL. 

PROTECT 

Changes  the  protection  bits  of  a  file. 

QUIT 

Exits  from  a  script  file  with  the  specified  error  code. 

RELABEL 

Changes  the  volume  name  of  a  disk. 

REMRAD 

Removes  the  recoverable  ramdrive.  device. 

RENAME 

Changes  the  name  of  a  file  or  directory. 

RESIDENT 

Loads  and  adds  commands  to  the  resident  list. 

RUN 

Executes  commands  as  background  processes. 

SEARCH 

Looks  for  the  specified  text  string  in  the  specified  files. 

SETCLOCK 

Sets  or  reads  the  real  time  clock. 

SETDATE 

Changes  the  date  and  time  of  a  file  or  directory. 

SETENV 

Sets  the  value  of  an  environment  variable. 

SETPATCH 

Makes  ROM  patches  in  Version  1.2  and  Version  1.3 
Kickstarts. 

SKIP 

Skips  ahead  when  executing  command  files. 

SORT 

Alphabetically  sorts  each  line  of  a  small  file. 

STACK 

Displays  or  sets  the  stack  size  of  the  current  CLI. 

STATUS 

Lists  information  about  the  CLI/SHELL  processes. 

TYPE 

Types  a  text  file. 

VERSION 

Finds  the  version  and  revision  numbers  of  Workbench, 
libraries,  or  devices. 

WAIT 

Causes  AmigaDOS  to  wait  a  specified  amount  of  time. 

WHICH 

Searches  the  command  path  for  a  specified  command. 

WHY 

Prints  an  error  message  explaining  why  a  command  failed. 
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Devs  Directory 


clipboard,  device 

Controls  writing  and  reading  clips  to  CLIPS:  or 
DEVS:  clipboards. 

MountList 

Contains  the  descriptions  of  devices  to  be  mounted. 

narrator,  device 

Controls  access  to  the  speech  synthesizer. 

parallel,  device 

Controls  access  to  the  parallel  port. 

printer,  device 

Controls  access  to  the  printer  device. 

ramdrive.  device 

Controls  access  to  the  recoverable  ramdrive. 

serial,  device 

Controls  access  to  the  serial  port. 

system-configuration 

Contains  the  current  Preferences  settings. 

Keymaps  subdirectory 

Contains  the  usal  keymap  file. 

Printers  subdirectory 

Contains  the  generic  printer  driver. 

Clipboard  subdirectory 

Clips  are  stored  here  if  CLIPS:  is  not  assigned. 

Fonts  Directory 

Fonts 

Sizes 

Ruby 

8,  12,  15  ' 

Opal 

9,12 

Sapphire 

14,  19 

Diamond 

12,20 

Garnet 

9,16 

Emerald 

17,20 

Topaz 

11 

L  Directory 


Aux-Handler 

Provides  unbuffered  serial  input  and  output. 

Disk-Validator 

Validates  disks  for  writing  when  they  are  inserted  into  a  drive. 

FastFileSystem 

A  file  system  for  use  with  hard  drives. 

Newcon-Handler 

Provides  an  interactive  SHELL  window. 

Pipe-Handler 

Provides  an  interprocess  communication  channel  between 
programs. 

Port-Handler 

Handles  the  DOS  interface  for  PAR:,  SER:,  and  PRT:. 

RAM-Handler 

Provides  file  storage  in  memory. 

SHELL-SEG 

Controls  the  SHELL. 

Speak-Handler 

Provides  speech  output  for  the  Amiga. 
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Libs  Directory 


diskfont.  library 

Contains  functions  for  finding  and  loading  resident  fonts. 

icon.library 

Contains  functions  for  creating  and  reading  icon  files  and 
string  manipulation  routines. 

info,  library 

Contains  code  for  the  Info  function  of  Workbench. 

mathieeedoubbas.library 

Contains  double  precision  IEEE  basic  mathematics  functions 
(addition,  subtractions,  etc.). 

mathieeedoubtrans.  library 

Contains  double  precision  IEEE  transcendental  math 
functions. 

mathtrans.  library 

Contains  mathffp  transcendental  math  functions  (sine,  cosine, 
etc.). 

translator,  library 

Contains  a  routine  for  translating  english  text  into  phonemes 
suitable  for  the  narrator  device. 

version,  library 

Contains  the  version  and  revision  numbers  of  the  Workbench 
release. 

Prefs  Directory 

CopyPrefs 

Copies  the  system-configuration  from  a  hard  disk  to  the 
Workbench  disk. 

Preferences 

Allows  you  to  change  various  settings  of  the  Amiga,  including 
the  screen  colors,  what  printer  driver  is  used,  the  shape  and 
color  of  the  pointer,  and  serial  device  settings. 

S  Directory 

CLI-Startup 

The  file  which  is  executed  whenever  a  new  CLI  is  started. 

DPAT 

A  script  file  which  can  add  pattern  matching  to  double 
argument  commands. 

PCD 

A  script  file,  similar  to  the  CD  command,  which  remembers 
the  last  directory. 

SHELL-Startup 

The  file  which  is  executed  whenever  a  new  SHELL  is  started. 

SPAT 

A  script  file  which  can  add  pattern  matching  to  single 
argument  commands. 

Startup-Sequence 

The  file  which  is  executed  whenever  the  Workbench  disk  is 
loaded. 

Startup-Sequence,  hd 

A  startup-sequence  that  transfers  control  to  a  hard  disk. 

StartupII 

The  file  which  is  run  by  the  initial  startup-sequence  and  which 
makes  many  AmigaDOS  commands  resident. 
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System  Directory 


CLI 

Allows  direct  communication  with  the  Amiga  through 
AmigaDOS  commands. 

DiskCopy 

Copies  the  contents  of  one  disk  to  another. 

FastMemFirst 

Changes  the  order  of  allocation  of.  memory  putting  FAST 
RAM  first. 

FixFonts 

Updates  the  .font  files  in  FONTS:. 

FORMAT 

Initializes  a  disk  so  that  it  can  be  used  with  the  Amiga. 

InitPrinter 

Initializes  a  printer  so  that  it  can  be  used  with  the  Amiga. 

MergeMem 

Merges  the  memory  lists  of  sequentially  configured  RAM 
boards. 

NoFastMem 

Forces  the  Amiga  to  use  only  resident  CHIP  RAM. 

SetMap 

Sets  the  keymap  to  be  used  with  a  keyboard. 

Utilities  Directory 

Calculator 

A  standard  four-function  calculator. 

Clock 

Displays  a  digital  or  analog  clock  on  the  Workbench  screen. 

ClockPtr 

Changes  the  Workbench  pointer  into  a  digital  clock. 

CMD 

Redirects  serial  or  parallel  output  to  a  file. 

GraphicDump 

Performs  a  graphic  dump  of  the  frontmost  Intuition  screen. 

InstallPrinter 

Copies  a  printer  driver  from  Extras  to  the  Workbench. 

MORE 

Displays  ASCII  text  files. 

Notepad 

Allows  the  creation  of  short  text  files. 

PrintFiles 

Copies  multiple  files  to  the  printer. 

Say 

A  speech  synthesizing  program. 

Please  note  that  the  .info  files  are  not  referenced  in  this  section.  Files  with  .info  suffixes  contain 
the  information  needed  to  display  icons  and  windows  and  to  start  applications.  Most  users  do 
not  need  to  access  these  files. 
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C.  REFERENCE  LIST  OF  DIRECTORIES/FILES  ON  EXTRAS 

Files  included  in  the  FD1.3  and  Basic  Demos  directories  pertain  to  the  programming  language 
Amiga  Basic.  For  more  information  on  these  directories,  please  refer  to  the  Amiga  Basic 
manual  which  was  packaged  with  your  Amiga  computer.  All  other  directories  on  Extras  are 
referenced  in  this  appendix. 


Devs  Directory- 

-Keymaps  subdirectory 

Keymap 

Compatible  Keyboard 

cdn 

French  Canadian 

chl 

Swiss  French 

ch2 

Swiss  German 

d 

German 

dk 

Danish 

e 

Spanish 

f 

French 

gb 

Great  Britain 

i 

Italian 

is 

Icelandic 

n 

Norwegian 

s 

Swedish 

usa2 

Dvorak 
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Devs  Directory— Printers  subdirectory 

Printer  Driver 

Compatible  Printers 

Alphacom Alphapro 101  Alphacom  Alphapro  101 

Brother_HR-15XL 

Brother  HR-15XL 

Calcomp ColorMaster 

ColorView-5912 

Calcomp ColorMaster2 

ColorView-5912 

Canon_PJ-1080A 

Canon  PJ-1080A 

CBM_MPS1000 

CBM  MPS1000,  Canon  BJ-130,  IBM  5152  Plus  printers 

Diablo— 630 

Diablo  630 

Diablo_Advantage D25 

Diablo  Advantage  D25 

Diablo_C-150 

Diablo  C-150 

EpsonQ 

Epson  Q  series  (LS1500,  LQ2500,  etc.) 

EpsonX 

Virtually  any  Epson  compatible  printer,  Commodore 
MPS1250 

EpsonXOld 

Epson  X  series,  Star  Micronics  Gemini  10-X 

Howtek Pixelmaster 

Howtek  Pixelmaster 

HP_DeskJet 

Hewlett-Packard  DeskJet 

HP__LaserJet 

Hewlett-Packard  LaserJet,  LaserJet  Plus  and  LaserJetll 

HP_PaintJet 

Hewlett-Packard  PaintJet 

HP_ThinkJet 

Hewlett-Packard  ThinkJet 

Imagewriterll 

Imagewriter,  Imagewriter  II 

Nee Pinwriter 

NEC  Pinwriter  P5,  P6,  P7,  P9,  P2200 

Okidata_92 

Okidata  92 

Okidata_2931 

Most  Okidata  printers  with  the  IBM  Plug-n-Print  card. 

Okimate_20 

Okimate  20  (Both  Serial  and  Parallel  Plug'n  Print  Kits) 

Quadram QuadJet 

Quadram  QuadJet 

Qume    LefterPro    20 

Qume  LetterPro  20 

Toshiba_P351C 

Toshiba  P351C,  other  Toshiba  24-pin  printers 

Toshiba_P351SX 

Toshiba  P351SX,  other  Toshiba  24-pin  printers 

Fonts  Directory 

Fonts 

Sizes 

Courier 

11, 13,  15,  18,  24 

Helvetica 

9,11,13,15,18,24 

Times 

11, 13,  15,  18,  24 
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PCUtil  Directory 


PCCopy 


Copies  files  from  a  5V4"  PC  disk  to  a  3>V2  Amiga  disk. 


PCFormat 


Initializes  a  b1/*'  disk  for  use  with  ToPCCopy. 


Read  Me 


Contains  text  describing  PCCopy,  PCFormat  and  ToPCCopy. 


ToPCCopy 


Copies  files  from  a  3V2"  Amiga  disk  to  a  bV*  PC  disk. 


Tools  Directory 


FED 

Modifies  and  creates  fonts. 

FreeMap 

Displays  chip  memory  usage. 

IconEd 

Changes  the  appearance  of  icons. 

IconMerge 

Merges  or  splits  icon  images. 

KeyToy2000 

Displays  the  global  keymap  of  an  Amiga  2000. 

MEMACS 

Edits  text  files. 

Palette 

Changes  the  colors  of  an  Intuition  screen. 

PerfMon 

Monitors  the  system's  performance. 

Please  note  that  the  .info  files  are  not  referenced  in  this  section.  Files  with  .info  suffixes  contain 
the  information  needed  to  display  icons  and  windows  and  to  start  applications.  Most  users  do 
not  need  to  access  these  files. 
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INDEX 


A2024  Monitor,  1-8 

A2090  Hard  Disk  Controller,  1-11,  5-6,  5-7,  A-2, 

A-3 
A2090A  Hard  Disk  Controller,  A-l,  5-6 
Absolute  print  limits.  1-10 
ADDBUFFERS,  2-1,  2-3,  B-l 
Aliases,  1-4,  1-5,  5-2,  5-5 
Alphacom  Alphapro  101,  4-1,  4-3,  C-2 
ASCII  files,  1-11,  1-13,  2-14,  6-8 
ASK,  2-1,  2-3,  B-l 
Aspect  ratios,  1-10,  1-11,  1-15,  4-2 
ASSIGN,  2-1,  2-4,  B-l 
Autoboot,  A-l 
Aux-Handler,  3-5,  B-3 
AVAIL,  2-1,  2-5,  B-l 


Background  processes,  2-24 

Baseline,  6-3 

BINDDRIVERS,  2-1,  2-5,  B-l 

Bind  key,  7-20,  7-24,  7-27 

BIX,  4-1,  4-3,  4-14,  4-15 

BlocksPerTrack,  3-2 

Blocks  transferred,  3-2 

Boot  block,  2-9,  2-15,  3-2 

BootPri,  3-3 

Bounded  print  limit,  1-10 

Brother  HR-15XL,  4-1,  4-3,  C-2 

Buffer, 
End-of-...,7-13,  7-22,  7-27 
Insert-...,  7-10,  7-22,  7-27 
Justify-...,  7-10,  7-23,  7-26 
Kill-...,  7-10,  7-24,  7-26 
List-...,  7-9,  7-22,  7-26 
Memory  . . . ,  2-3,  3-2 
Select-...,  7-3,  7-9,  7-22,  7-26 
Top-of-...,7-13,  7-22,  7-27 


BREAK,  2-1,  2-30,  B-l 
BufMemType,  3-2 


Calcomp 
ColorMaster,  4-1,  4-4,  C-2 
ColorMaster2,  4-1,  4-4,  C-2 

Calculator,  1-11,  B-5 

Cancel,  7-11,  7-22,  7-25 

Canon 
PJ-1080A,  4-1,  4-4,  C-2 
BJ-130  printer,  4-5,  C-2 

Cap-word,  7-16,  7-23,  7-27 

Case 
Switch-...,  7-16,  7-23,  7-27 


CBM  MPS1000,  4-1,  4-5,  C-2 

CBM  MPS1250,  4-5,  4-7,  C-2 

CD,  2-1,  2-30,  3-9,  B-l 

Centering,  1-9 

Change  Printer  Window,  1-8,  1-13,  4-1 

Change  Serial  Window,  1-8 

CHANGETASKPRI,  2-1,  2-6,  B-l 

CHIP  RAM,  1-5,  2-5,  2-26,  3-2,  6-4,  6-7 

CLI,  1-1,  1-2,  1-3,  2-32,  B-5 

closing,  2-10 

-command,  7-7,  7-22,  7-26 

New-...,  7-7,  7-22,  7-25 

opening,  2-19 

-startup  file,  1-1,  1-2,  2-19,  B-4 
Clipboarddevice,  1-17,  3-1,  3-3,  B-3 
Clips,  1-17,  3-1,  3-3 
Clock,  1-11,  1-16,  B-5 
ClockPtr,  1-12,  B-5 
CMD,  1-12,  1-13,  B-5 

CMD WRITES,  1-12 

Color  correction,  1-9 
ColorView-5912  printer,  4-4 
Command  lines,  1-3,  3-6 
Comments,  1-5,  2-7,  2-13 
CON:,  1-2,  3-4,  3-5 
Condition  Flag,  2-2 
Conditional  operations,  2-14,  2-30 
Control  characters,  3-6 
COPY,  2-1,  2-6,  2-7,  B-l 
CopyPrefs,  1-7,  1-11,  B-4 
Copy-region,  7-9,  7-24,  7-27 
CPU  time,  6-7 

DATE,  1-12,  2-1,  2-7,  B-l 
DELETE, 

AmigaDOS,  2-1,  2-7,  B-l 

-back,  7-15,  7-24,  7-27 

-blanks,  7-15,  7-24,  7-26 

-forw,  7-15,  7-14,  7-27 
Density,  1-9,  4-2,  4-3 
Describe  key,  7-20,  7-24,  7-27 
Device 

drivers,  2-5 

files,  3-1,  B-3 

keyword,  3-1,  3-2,  3-3 

name,  2-4 

node,  2-19 
DEVS:,  3-1 
Diablo 

630,  4-1,  4-5,  C-2 

Advantage  D25,  4-1,  4-6,  C-2 

C-150,  4-1,  4-6,  C-2 
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DIR,  2-1,  2-8,  B-l 
DISKCHANGE,  2-1,  2-8,  B-l 
DiskCopy,  1-5,  B-5 
DISKDOCTOR,  2-1,  2-9,  B-l 
Dithering,  1-8,  1-9,  4-3 
DosType  keyword,  1-7,  2-9,  3-3,  A-4 
DPAT,  1-5,  3-9,  B-4 

ECHO, 

AmigaDOS,  2-1,  2-10,  B-l 

MEMACS,  7-21,  7-24,  7-27 
ED,  2-1,  2-30,  B-l 
EDIT,  2-1,  2-30,  B-l 
ELSE,  2-1,  2-30,  B-l 

Emacs pro,  7-21 

End 

-of-buffer,  7-13,  7-22,  7-27 

-of-window,  7-13,  7-23,  7-27 

-of-line,  7-14,  7-22,  7-25 
ENDCLI,  2-1,  2-10,  B-l 
ENDIF,  2-1,  2-14,  2-30,  B-l 
ENDSKIP,  2-1,  2-10,  B-l 
ENV:,  1-14,  1-17,  2-13,  2-25,  5-2,  5-4 
Environment  variables,  1-14,  1-17,  2-13,  2-15, 

2-25 
Epson 

Q  series  printers,  4-1,  4-6,  4-7,  C-2 

X  series  printers,  4-1,  4-7,  4-8,  C-2 
Error  messages,  2-1,  2-2,  2-31,  2-32 
EVAL,  2-1,  2-11,  2-12,  B-l 
EXECUTE 

AmigaDOS,  2-1,  2-12,  B-l 

-file,  7-20,  7-24,  7-27 

-line,  7-20,  7-24,  7-25,  7-27 

-macro,  7-19,  7-24,  7-26 
Expand-window,  7-12,  7-23,  7-26 
Expansion  memory,  1-5,  1-6,  3-1 

FAILAT,  2-1,  2-2,  2-31,  B-l 
Fast  RAM,  1-5,  1-6,  2-5,  6-4,  6-7 
FastFileSystem,  1-6,  2-3,  2-9,  2-18,  3-2,  3-3, 

A-l  to  A-4,  B-3 
FastFonts,  2-13 
FastMemFirst,  1-6,  B-5 
FastText,  2-13 
FAULT,  2-1,  2-31,  B-l 
FED,  6-1,  6-2,  6-3,  C-3 
Fence-match,  7-17,  7-24,  7-27 
FF,  2-1,  2-13,  B-l 
FILENOTE,  2-1,  2-13,  B-l 
File 

comments,  1-5,  2-7,  2-13 

Execute-...,  7-20,  7-24,  7-27 

Insert-...,  7-6,  7-22,  7-26 

joining  files,  2-16 

Read-...,  7-2,  7-5,7-22,  7-26 


Save-...,  7-6,  7-22,  7-26 

Save-as-...,  7-6,  7-22,  7-26 

systems,  1-6,  2-15,  3-1,  3-2 

Visit-...,  7-3,  7-5,7-22,7-26 
Filtering,  6-8 

Fixed  width  spacing,  3-4,  6-3 
FixFonts,  1-5,  1-7,  3-4,  B-5 
Flags  keyword,  3-2 
Floppy  disks 

5V4",  2-8,  6-7,  6-8 

fixing  corrupt,  2-9 
Floyd-Steinberg  dithering,  1-8, 1-9,  4-3 
fonts,  1-7,  3-4,  6-1,  6-2,  6-3,  C-2,  B-3 
FONTS:,  1-7,  3-4,  B-3 
FORMAT,  1-6,  B-5 
Formatting  disks,  1-6,  6-7,  6-8 
FreeMap,  6-1,  6-4,  C-3 

Gemini  10-X  printer,  4-8 

Generic  printer  driver,  4-1,  4-9,  B-3 

GETENV,  1-14,  1-17,  2-1,  2-13,  2-25,  B-l 

GlobVec  keyword,  3-2 

Goto-line,  7-13,  7-22,  7-26 

GraphicDump,  1-11,  1-15,  B-5 

Half-tone  dithering,  1-9 

Handlers,  3-1,  3-2,  3-4  to  3-8,  B-3 

Hard  disk  partitions,  2-18,  3-2,  5-3,  A-l  to  A-4 

HighCyl,  3-2 

Howtek  Pixelmaster,  4-1,  4-9,  C-2 

HP 

DeskJet,  4-1,  4-9,  C-2 

LaserJet,  4-1,  4-9,  C-2 

LaserJetPlus,  4-1,  4-9,  C-2 

Paintiet,  4-1,  4-10,  C-2 

ThinkJet,  4-1,  4-10,  C-2 

IconEd,  1-5,  6-1,  6-4,  C-3 

IconMerge,  6-1,  6-4,  6-5,  C-3 

Icons,  1-2,  1-3,  6-1,  6-4,  6-5 

ICONX,  2-1,  2-14,  B-l 

IF,  1-17,  2-1,  2-14,  2-15,  B-l 

Imagewriter  printers,  4-1,  4-10,  4-11,  C-2 

Indent,  7-11,  7-23,  7-25 

INFO,  2-1,  2-15,  B-l 

Info  menu  item,  1-2,  1-12 

Initialize 

disks,  1-6 

printers,  1-7 
InitPrinter,  1-5,  1-7,  B-5 
Insert 

-buffer,  7-10,  7-22,  7-27 

-file,  7-6,  7-22,  7-26 
INSTALL,  2-1,  2-15,  B-2 
InstallPrinter,  1-8,  1-11,  1-13,  4-1,  B-5 
Integer  scaling,  1-9 
Interleave,  3-2 
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JOIN,  2-1,  2-16,  B-2 
Justify-buffer,  7-10,  7-23,  7-26 

Kerning,  6-2 
Key 

Bind...,  7-20,  7-24,  7-27 

Describe...,  7-20,  7-24,  7-27 

Set-...,  7-19,  7-24,  7-26 

Unbind...,  7-21,  7-24,  7-27 
Keyboards,  1-6,  1-7 
Keymaps,  1-6,  1-7,  3-3,  3-4,  C-l 
Keys 

Reset-...,  7-20,  7-24,  7-27 
KEYTOY2000,  6-1,  6-5,  C-3 
Keywords,  3-1,  3-2,  3-3 
Kickstart,  1-18,  2-27,  A-l 
Kill 

-buffer,  7-10,  7-24,  7-26 

-line,  7-14,  7-24,  7-26 

-region,  7-8,  7-24,  7-25 

-to-eol,  7-14,  7-24,  7-25 

L:,  3-1,  3-4,  B-3 

LAB,  2-1,  2-31,  B-2 

Left  offset,  1-8 

Libraries,  2-28,  3-9 

LIBS:,  3-1,  3-9,  B-4 

Limits,  1-10 

Line 
End-of-...,7-14,  7-22,  7-25 
Execute-  . . . ,  7-20,  7-24,  7-25,  7-27 
Goto-  . . . ,  7-13,  7-22,  7-26 
Kill-...,  7-14,  7-24,  7-26 
Next-...,  7-15,  7-22,  7-25 
Open-...,  7-14,  7-23,  7-25 
Prev-...,7-15,  7-22,  7-25 
Show-  . . .  #,  7-15,  7-22,  7-26 
Start-of-...,7-14,  7-22,  7-25 
-to-top,  7-15,  7-23,  7-27 

List-buffers,  7-9,  7-22,  7-26 

LIST,  2-1,  2-16,  2-17,  B-2 

LOADWB,  2-1,  2-18,  B-2 

LOCK,  2-1,  2-18,  B-2 

Logical  device  names,  2-4,  5-2,  5-3 

LowCyl,  3-2 

Lower 
-region,  7-9,  7-23,  7-26 
-word,  7-15,  7-23,  7-27 

Macros 
Execute-  ...,7-19,7-24,7-26 
Start-...,  7-18,  7-24,  7-26 
Stop-...,  7-18,  7-24,  7-26 

MAKEDIR,  2-1,  2-31,  B-2 

Margins,  1-8,  1-10,  1-11 


Mark 
Set-...,  7-2,  7-8,7-23,7-25,  7-27 
Swap-dot&  . . . ,  7-2,  7-13,  7-22,  7-26 

Mask,  3-2 

Mathieeedoubbas.  library,  3-9,  B-4 

Mathieeedoubtrans.  library,  3-9,  B-4 

MaxTransfer,  3-2 

Memory  Lists,  1-6 

MergeMem,  1-6,  B-5 

MORE,  1-11, 1-13, 1-14, 1-17,  2-22,  5-4,  B-5 

MOUNT,  2-1,  2-19,  3-1,  3-2,  A-l,  A-2,  B-2 

MountList,  1-18,  2-19,  3-1,  3-2,  3-3,  5-5,  A-2, 
A-3,  A-4,  B-3 

NEC  Pinwriter,  4-1,4-11,0-2 

New-CLI,  7-7,  7-22,  7-25 

NEWCLI,  2-1,  2-19,  B-2 

NEWCON:,  1-1,  1-2,  2-19,  3-4,  3-5,  3-6,  B-3 

NEWSHELL,  1-4,  2-1,  2-19,  3-8,  B-2 

Next 

-line,  7-15,  7-22,  7-25 

-page,  7-13,  7-22,  7-25 

-w-page,  7-10,  7-26,  7-27 

-window,  7-12,  7-23,  7-26 

-word,  7-13,  7-22,  7-25 
NoFastMem,  1-5,  B-5 
Notepad,  1-11,  2-14,  B-5 

Okidata 

92,  4-1,  4-12,  C-2 

2931,  4-1,  4-12,  C-2 
Okimate20,4-1,4-13,  C-2 
One-Window,  7-12,  7-23,  7-26 
Open-Line,  7-14,  7-23,  7-25 
Ordered  dithering,  1-9 
Output 

parallel,  1-12 

serial,  1-12,  3-5 

speech,  3-7,  3-8 

Page 

Next-...,  7-13,  7-22,  7-25 

Next-w-...,7-12,  7-26,  7-27 

Prev-...,7-13,  7-22,  7-27 

Prev-w-...,  7-12,  7-26 
Palette,  6-1,  6-6,  C-3 
Parallel 

.device,  3-1,  B-3 

output,  1-12 
Parameters  (MEMACS),  7-18 
PATH,  1-5,  2-1,  2-20,  B-2 
Pattern  matching,  1-5,  2-7,  3-8 
PCCopy,  6-7,  C-3 
PCD,  3-9,  B-4 
PCFormat,  6-7,  6-8,  C-3 
PC  Utilities,  6-7,  6-8,  C-3 


1-3 


Index 


PerfMon,  6-1,  6-7,  C-3 

PIPE:,  1-14,  3-6,  3-7,  B-3 

Pointer,  1-7,  1-11,  1-12 

PreAlloc,  3-2 

Preferences,  1-7,  1-8,  4-1,  4-2,  6-6,  B-4 

Prefs,  1-7,  B-4 

Prev 

-line,  7-15,  7-22,  7-25 

-page,  7-13,  7-22,  7-27 

-w-page,  7-12,  7-26 

-window,  7-12,  7-23,  7-26 

-word,  7-14,  7-22,  7-27 
Printer  Drivers,  1-8,  1-11,  1-13,  4-1  to  4-18 
PrintFiles,  1-11,  1-14,  B-5 
Printing 

color,  1-19,  4-2 

multiple  files,  1-14 

screens,  1-15 

speed,  4-2 
Printout  size,  1-10,  1-11,  1-15 
Print  Shade,  1-8 
Priority,  2-6,  3-2,  3-3 
Project  icon,  1-2 
Proportional  spacing,  3-4,  6-2 
PROMPT,  2-1,  2-20,  B-2 
PROTECT,  1-5,  2-1,  2-21,  B-2 
Protection  bits,  1-4,  2-7,  2-16,  2-21 
PURE  commands,  2-22,  2-23 

Quadram  QuadJet,  4-1,  4-13,  C-2 
Query-s-r,  7-17,  7-24,  7-27 
QUIT 

AmigaDOS,  2-1,  2-31,  B-2 

MEMACS,  7-7,  7-22,  7-25,  7-26 
Qume  LetterPro  20,  4-1,  4-13,  C-2 
Quote-char,  7-10,  7-11,  7-23,  7-25,  7-26,  7-27 

RAD:,  1-17,  1-18,  5-2,  5-5,  5-6,  5-9 

RAM:,  1-17,  2-13,  2-25,  3-3,  5-2,  5-4,  B-3 

Read-file,  7-5,  7-22,  7-26 

Rebooting,  1-17,  1-18,  5-3,  5-5 

Recoverable  ramdrive,  1-17, 1-18, 2-21, 3-1, 3-3, 

5-2,  5-5,  5-6,  5-9,  A-4 
Redirection,  1-5 
Redisplay,  7-10,  7-23,  7-25 
Region 

Copy-...,  7-9,  7-24,  7-27 

Kill-...,  7-8,  7-24,  7-25 

Lower-...,  7-9,  7-23,  7-26 

Upper-...,  7-9,  7-23,  7-26 
RELABEL,  2-1,  2-8,  2-31,  5-4,  B-2 
REMRAD,  1-17, 1-18,  2-1,  2-21,  B-2 
RENAME 

AmigaDOS,  1-17,  2-1,  2-32,  B-2 

MEMACS,  7-2,  7-5,  7-22,  7-26 
Reset-keys,  7-20,  7-24,  7-27 


RESIDENT,  1-4,  1-5,  2-1,  2-22,  2-23,  3-8,  B-2 
Resident  commands,  1-4,  1-5,  2-22,  2-23,  5-2, 

5-4 
Resident  list,  2-22,  2-29 
ROM  patches,  2-26 
ROMWACK,  2-18 
RUN,  2-1,  2-24,  B-2 

S:,  3-1,  3-8 
Save 

-as-file,  7-6,  7-22,  7-26 

-exit,  7-6,  7-22,  7-26 

-file,  7-6,  7-22,  7-26 

-mod,  7-6,  7-22,  7-26 
Say,  1-5,  1-11,  B-5 
Scaling,  1-9,  1-10 
Screen 

colors,  6-1,  6-6 

dumps,  1-15,  4-2,  4-3 
Script  files,  1-5, 2-3, 2-12, 2-14,  2-1*6, 2-17, 2-30, 

2-31,  3-1,  3-8 
Scroll 

-down,  7-14,  7-23,  7-27 

-up,  7-14,  7-23,  7-25 
SEARCH 

AmigaDOS,  2-1,  2-24,  B-2 

-backward,  7-16,  7-24,  7-25,  7-26 

-forward,  7-26,  7-24,  7-25,  7-26 

-replace,  7-16,  7-24,  7-25 
Seiko 

5300,  4-1,  4-14 

5300a,  4-1,  4-14 
Select-buffer,  7-3,  7-4,  7-22,  7-26 
Serial 

.device,  3-1,  B-3 

output,  1-11,  1-12 

port,  3-5 
Set,  7-18,  7-22,  7-27 

-arg,  7-17,  7-22,  7-25 

-key,  7-19,  7-24,  7-26 

-mark.  7-2,  7-8,  7-29,  7-23,  7-25,  7-27 
SETCLOCK,  1-12,  2-1,  2-25,  B-2 
SETDATE,  2-1,  2-25,  B-2 
SETENV,  1-14,  1-17,  2-1,  2-13,  2-25,  2-26,  5-4, 

B-2 
SetMap,  1-5,  1-7,  3-3,  3-4,  B-5 
SETPATCH,  2-1,  2-26,  B-2 
SHELL,  1-1  to  1-5,  2-20,  2-22,  3-8 

closing,  2-10 

history  buffer,  1-3,  3-6 

opening,  2-19,  5-2,  5-3 

prompt,  2-20 

-startup  file,  1-1,  1-2,  1-4,  2-19,  2-24,  5-2,  5-5, 
B-4 
SHELL-SEG,  3-8,  B-3 
Show-line#,  7-15,  7-22,  7-26 
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